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ABSTRACT 


Special Forces are crucial in specific military operations. They usually operate in 
hostile territory where communications are difficult to establish and preserve, since the 
operations are often carried out in a remote environment and the communications need to 
be highly mobile. The delivery of information about the geographical parameters of the 
area can be crucial for the completion of their mission. But in that highly mobile 
environment, the connectivity of the established wireless networks (LANs) can be 
unstable and intermittently unavailable. 

Existing content transfer protocols are not adaptive to volatile network 
connectivity. If a physical connection is lost, any information or part of a file already 
retrieved is discarded and the same information must be retransmitted again after the 
reestablishment of the lost session. The intention of this Thesis is to develop a protocol in 
the application layer that preserves the already transmitted part of the file, and when the 
session is reestablished, the information server can continue sending the rest of the file to 
the requesting host. Further, if the same content is available from another server through 
a better route, the new server should be able to continue to serve the content, starting 


from where the session with the previous server ended. 
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I. INTRODUCTION 


A. PROBLEM STATEMENT 

One of the major problems during the operation of a wireless mobile LAN, is the 
reliability of the content delivery under difficult networking conditions. Currently, an 
error or connection loss during a data transfer session can only be handled by 
retransmitting the data. However, in the wireless network established to support Special 
Forces teams in a highly mobile environment, the timely delivery of information is 
essential for the accomplishment of the mission. In this case, a more rapid and dynamic 
data recovery must be achieved, so that the interrupted data transfer session can be 


continued from the point it stopped. 


B. RESEARCH QUESTIONS 


Addressing the above problem, the current research will address the following 


questions: 
e What is an appropriate design for a file transfer application so that partial 
file retrieval can be achieved? 
e What is an example of a high-layer communication protocol that can be 
used in this application? 
e How can this application design support the use of mobile devices? 
e How can this communication model be flexible when the availability of 


the information servers varies? 


C; SCOPE AND METHODOLOGY 


1. Scope 

The scope of the thesis is to develop a client-server file transfer application 
named PFTP (Partial File Transfer Protocol) to demonstrate a possible solution to the 
problem of a lack of persistent data sessions in wireless mobile networks and LANs. For 
this purpose, a prototype communication protocol between the client and the server will 
be designed to achieve dynamic partial file retrieval in the event of connection loss. The 
goal is to produce an application user interface that visualizes the partial file retrieval 


process in real time. 


2 


Methodology 


This thesis research will follow the methodology below: 


Search for partial file transfer capabilities in the existing file transfer 
protocols 


Specify the application’s requirements for both the user interfaces and the 
communication protocol 


Design and develop a file transfer application using Java programming. 


Test the application in a wireless environment, against several scenarios 
simulating real situations that can occur. 


Assumptions and Limitations 
a. Assumptions 


Programming Language. The development of the application will be done 
with Java Technology programming. As Java programming support 
becomes more and more powerful, it contains the tools necessary to 
support the development of both user interface and communication 
protocol specific components for the purpose of the thesis research. 


Mobile Device. The mobile platform for the mobile client of this 
application is a Pocket PC technology device, which possesses a more user 
friendly file management system. 


b. Limitations 


Security. Except for the file authentication that is achieved with the file 
hash value exchange procedure during the transfer process, the security 
aspect of this protocol is not covered in the manner in which it can support 
the military use of the application. A secure tunneling design would be 
appropriate to encapsulate each session between the client and server. 


File Database Management. The application server has _ limited 
functionality in the file database management. The server side creates a 
local file database that holds the files that are decided by the server 
administrator to be available for the clients before it runs. 


Scalability. Even though the multithreading approach is used to design the 
server side of the application, this thesis research does not address the 
capability to support a large number of users that produce heavy traffic on 
a single server. 


D. ORGANIZATION 

The covered material is organized into the following chapters in order to fulfill 
the objectives of this thesis. Chapter IT will refer to all the available file transfer protocols 
and how a built in capability exists in some of them for partial file retrieval. Chapter II 
will cover the application design consisting of the requirements and the UML diagrams. 
Chapter IV will describe the development process, referring to the developments tools 
used, the user interface functionality and how the most important features of the 
application are implemented for both the client and server side. Chapter V will address 
the testing phase of the application development. Specific scenarios will test the manner 
in which applications respond to any file transfer case. Finally, Chapter VI will present 
recommendations, conclusions, and further work to be done in the establishment of 


persistent data sessions in file transfers within a mobile LAN. 
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Ii. BACKGROUND 


This chapter refers to some of the most known file transfer protocols and how 
some have features that can enable a form of partial file recovery. Also, it contains 
information about the mobile devices’ networking characteristics, as far as the file 


transfer protocols they are using. 


A. EXISTING FILE TRANSFER PROTOCOLS 


1. File Transfer Protocol (FTP) 

FTP is the oldest of the current file transfer protocols, introduced for the first time 
in 1971 [1] .The last specification for this protocol is described in Ref.[2]. FTP is a user— 
level protocol for file transfer among hosts and terminal Interface Message Processors 


(IMP) and it uses the Data Transfer Protocol (DTP)[3] to transfer the file data. 


The main goals of the FTP protocol are to: 


e Use the remote file storage between hosts conveniently 
e Promote the sharing of files 
e Encourage its use by computer programs. Even though FTP can be used 


by a PC user, it is designed for use by programs 


e Keep the user safe from any difference in file storage systems among host 
operating systems 


e Achieve reliable and efficient data transfers 

The communication model of FTP is based on the establishment of two 
bidirectional connections between the client and the server, the Control Connection 
using port 21 for the exchange of the FTP commands and replies using Telnet protocol, 
and the Data Connection using port 20 for the data transfers using the TCP protocol 
(Figure 1). The protocol interpreter of the client side is that which initiates the control 
connection using the Telnet protocol. After the initiation of the control connection, the 
user protocol interpreter generates and sends the FTP commands to the server that uses 


standard replies to respond through the control connection. 
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Figure 1. | The use model of the FTP protocol 


FTP commands specify the parameters of the data connection such as the transfer 
mode, data port, file structure and representation type, and what kind of file operations 
are requested such as retrieve , store and delete. The server then initiates the data 
connection to a data transfer port that is specified by the user, and sends the data applying 
the parameters. The client must listen to that port that also can be different from the port 
client used to initiate the control connection. Except for this client-server data transfer, 
FTP provides the capability so that the user on the client side can tell the server to send 


the data to another FTP server host (Figure 2). 
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Figure 2. The alternative use model of the FTP protocol 


In that case, control connections are initiated by the client protocol interpreter 
with both protocol interpreters of the two server hosts but the data connection is 
established between the two servers for exchanging the file data. The server that sends 
the data in both cases mentioned above is responsible for initiating, maintaining, and 


closing the data connection. 


Three transmission modes must be supported by every implementation of the FTP 
protocol for the file data transfer to occur. They are the stream mode, the block mode and 
the compressed mode. In all modes, an end-of-file (EOF) marker, depending on the file 
structure, must explicitly or implicitly indicate the end of the data transfer or the close of 


the data connection is identified as the end of the file indicator. 


In the stream mode, the file data are transmitted as a stream of bytes without 
excluding the record structured files. In the block mode, files are a series of data blocks 
that have a tree byte header that contain a one—byte descriptor code and a two—byte count 


field (Figure 3). 





Desciptor Code Count Field 
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Figure 3. The data block header in the block transmission mode of FTP 


The descriptor code field indicates the end of file (EOF), the end of record (EOR), 
the restart marker or the suspected for errors data marker with bit flags. The count field 
indicates the total length in bytes of the data blocks. In compressed mode, the 
information that must be sent is the actual data in a form of byte string, the compressed 
data that consist of replications or filler and control information [2]. The n data bytes are 


compressed to one replicated byte (Figure 4). 
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Figure 4. | Compression of data bytes in the compressed mode of FTP 


In general, FTP does not have mechanisms to detect if any bit loss or the data 
received is scrambled. This kind of low level error control is handled by the underlying 
TCP. However, in the case of a long data transfer, such as in big files, and in the block or 
compressed transfer mode, a restart procedure exists that is trying to protect the user 
from the failures of hosts or the underlying network during the data transfer. The 
procedure is based on special market codes that represent a data—unit counter (bit, byte or 
record), that the sender inserts in the data stream at some points. Those markers, also 
known as checkpoints, in the case of a system failure, act as milestones in the transfer 
process and can be used by the user to ask for data recovery by sending a restart 


command, with the marker code identified. 


However, even though this error recovery feature exists, Ref. [2] does not 
mention any implementation details and an agreement between FTP client/server vendors 
about a common format for the restart markers does not exist, and therefore, they can be 


used effectively. 


2. Trivial File Transfer Protocol (TFTP) 

TFTP is a very simple protocol that is used to transfer files and is described in Ref 
[4] and revised by Ref [5]. It is designed to be on top of the UDP protocol even though 
other transport protocols are not excluded. To keep its implementation as simple as 


possible, TFTP does not have features that can be found in FTP protocol such as 


directory listing and user authentication. Files can be transferred with three modes, 
netascii (8 bit ascii mode) which is a standard for transferring text files, octec mode 


which is for transferring binary files, and mail mode which is for mail!. 


The communication protocol starts with the TFTP client sending a read or write 
request on port 69 of the TFTP server to read or write a file. If the server accepts the 
request, then a connection is established and the data are sent in fixed blocks of 512 
bytes. Each non-terminal data packet must be acknowledged before the sender sends the 
next one. If a timeout period is passed without acknowledge reception for a packet, this 
packet is resent. Packet reception with a length less than 512 bytes indicates a terminal 


file data block and the termination of a file transfer (Figure 5). 





TFITP TFTP 
Server Client 
Data{ 1] 

pck(t] is 
be Data[2] 
ack\2) 
“4 
Loss 
Datal2] 
pck2\ > 
a 
Data[n-1] 
pckirrtl > 
la Dataln] (length <512) 
> 
Transfer Termination 











Figure 5. Data transfer sequence in TFTP 


! Mail mode is not implemented in commercial TFTP applications. 
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In case of a lost packet, the receiver sends its last transmitted packet to indicate 


this loss and to cause the sender2 to resend it. 


There are four types of messages that are exchanged between the client and the 


server: 
e Read request message 
e Write request message 
° Data message 
e Acknowledge message 
° Error message 


All message packets have a 2 byte front opcode that identifies the format of TFTP 


messages and then the data depending on the message type. Figure 6 shows the packet 


structure of different message packets. 


Read Request Message: 


Write Request Message: 


Data Request Message: 


Acknowledge Message: 


Error Message: 
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File Name field, Transfer Mode field: a null terminated variable length field 


Figure 6. 


Messages structure of TFTP 


2 The sender in TFTP must keep one previous sent data packet in case of packet loss. 
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When an error occurs (an error message received) during the file transfer, the 
designed reaction of the TFTP protocol is to terminate the connection. The error message 
is not acknowledged, so when an error message has been lost, the receiver uses a timeout 
period to detect this connection termination. In this protocol after an abnormal 
termination, no procedure exists to retrieve the lost part of a file after a connection failure 


during transfer. 


3. Simple File Transfer Protocol (SFTP) 

The simple file transfer protocol (SFTP) is a protocol designed to be more useful 
than TFTP but not as powerful as FTP [6]. SFTP uses one TCP connection to transfer the 
files compared to one UDP connection of the TFTP protocol and the two TCP 
connections of FTP. This characteristic gives the SFTP the ability to support: 


e File transfers 

e Directory listing and changing 
° User access control 

e File deleting and renaming 


The SFTP communication protocol starts with the client side connecting to the 
server on port 115 via TCP. Then, the client sends commands to the server and waits for 


responses. The SFTP commands and replies are in the form of: 


Commands : <4 ASCII character command> [<space> <arguments>] <null> 


Replies : <1 ASCII response character> [<ASCII message string>] <null>. 
In Table 1, all the possible commands and replies are listed with a short 


description. Also, Figure 7 shows an example of a command-reply exchange that leads to 


file transfer. 
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DESCRIPTION 



























































USER The user ID on the server system 
ACCT The account to use on the server system. 
PASS The password on the server system 
TYPE The mapping of the stored file to the transmission byte stream is 
controlled by the type. The default is binary if the type is not specified. 
LIST Lists the directory contents. 
CDIR Changes the current directory on the server host to the given one. 
KILL Deletes the file from the server system. 
NAME Renames the file on the server system. 
DONE Tells the server system that the process is finished. 
RETR Requests that the server system send a specified file. 
STOR Tells the server system to receive a file and save it under the name 
given. 
REPLY DESCRIPTION 
+ Success. 
- An error has occurred 
! Logged In 
<space> Number 
Table 1. _ Commands and replies of a SFTP communication protocol 
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Figure 7. 


In SFTP, no way exists to retrieve the remaining part of the file if the traditional 


TCP connection fails during the transmission of file bytes. 


Comect to Port 115 with TCp 


ACE 
pegerverHost > SFTP Servic 


USER 


<uSer Names 


user name> ok send password 
KX 


esize in bytes 
SEND 


Server sendthe we 


DONE 


ion 
connecitlo 
Host> close 
+ <Server 


4. Hypertext Transfer Protocol (HTTP) 


The Hypertext Transfer Protocol (HTTP) as described in Ref. [7] is an 


application—level protocol that is used for the transfer of hypermedia information on the 
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SFTP 
Server 





An example of a file transfer connection in SFTP 





Internet. HTTP is a request /response type of transfer protocol. The client opens a 
connection with the server and sends a request. The server responds to this request and 
closes the connection. These connections can be persistent by choosing TCP as the 


underlying protocol. 


The client side user initiates the communication protocol connecting to port 80 of 
the HTTP server host and sends a request. The client request can be fulfilled by three 
general cases. In the first case, the client request reaches the origin server through a 
single connection and the response comes from the same connection and server (Figure 
8(a)). In the second case, there are some intermediaries, such as gateways and proxies, 
between the client and the origin server that maybe do not understand the message but act 


as a relay point (Figure 8(b)). 


The third is the case when the HTTP request and responses between the client 
user and origin server can be cached and reused to lower the traffic to the origin server 


(Figure 8(c)). 


HTTP Request 
HTTP Pesporse o 
$$ << rT Ss 
User 


Origin Server 
(a) 




















HTTP Request HTTP Request HTTP Request 
> > —> 
HTTP Response HTTP Response HTTP Response = 
+ + « Ss 
a Server A Server B Origin Server 
(b) 
HTTP Request HTTP Request 
> —> 
HTTP Response HTTP Response 
< —— x 
= Server A Server B Origin Server 


Cashed HTTP responses 
for previous HTTP request 


(°) 
Figure 8. The types of request fulfillment in HTTP protocol 
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HTTP protocol is designed so that it is possible to request one or more parts (or 
ranges) of a hypermedia information file, instead of the entire file. For that purpose, 
special range request headers can be used and the HTTP servers, as is proposed by 
Ref.[5], ought to support range request headers when possible, because it is an efficient 


way to recover from the partially failed transfer of large files. 


B. FILE TRANSFER IN MOBILE/ HANDHELD DEVICES 

By the time people become accustomed to having a mobile or a handheld device 
which helps them stay connected with other people or organize their business or family 
life, new capabilities have been examined to bring those devices to the Internet and inter— 
networking community. Newer enhancements in mobile phones bring the Internet—-ready 
cellular phones or Web phones in use, making them able to access the Web, running 
micro—browsers. Wireless enabled handheld devices, such as Palm or Pocket PCs, having 
more computational power and memory, can also store data locally in the form of records 
or regular files respectively. Due to the need for Internet access, the most popular file 
transfer protocols among these devices is HTTP, but software vendors have not enabled 
any partial recovery capabilities, where they are available and the only way to handle a 


failed file transfer connection is to resend the file. 
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Ht. APPLICATION DESIGN 


This chapter presents the initial requirements that the application addresses. In 


Section B, the UML diagrams show how the application is designed in greater detail. 


A. REQUIREMENTS 
1. Functional Requirements 
a. User Interface 
The PFTP application will provide a user interface for both the client-side 
and server-side modules. In this initial version, and for the purpose of the thesis research, 
the user interface must provide four main services to the client-side user. They are: 


° Control of the file transfer communication. The user must be able to 
control different options of the file transfer, such as the file name, server 
selection/configuration mode, and the packet size. Also, there must be an 
option for the user to stop or cancel the file transfer at any time. 


e View of the file transfer progress. A file transfer progress bar with the 
percentage of the transfer finished will be sufficient. 


e View of the file transfer status. Useful information must be accessible by 
the user during the file transfer. 


e Visual preview of the file during transfer in the case of an image file. 
These services can be represented as separate panels on the main user 
interface frame. Figure 9 shows a primitive preview of an example of a PFTP client side 


user interface. 


ig: 


PFIP Client 
Control Panel 


Image Progress Panel 


Transfer Status Pane 


Transfer Progress Panel 





Figure 9. | Preview of the client’s user interface in PFTP application 


In the Pocket PC version of the PFTP client, it is not possible to show all 
the above-mentioned panels concurrently, due to the screen size of this device. In that 
case, the control panel will be the main panel and the image progress panel will appear 


when the file is downloading. 


PFT|P Pocket PC Client PFTP Pocket PC Client 


Control Panel Image Progress Panel 





Figure 10. Preview of the Pocket PC version client’s user interface 


The PFTP server-side user interface must support limited control and 


administration functionality for the server application. These functions will be: 
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e Limited server application control. A simple starting and stopping 
functionality will be available. 


e File database management. The server has a local file database that keeps 
the files available to clients for transfer. The server application user can 
add or remove files from the database. 


e Monitoring the server’s operation. When the server starts, a panel must be 
present to show the operation status and some connection failure statistics. 


The first two of the above functionalities can be available as a menu item 
in a menu bar at the top of the user interface. Under this a panel can be placed displaying 
a logo before the server application starts or the server-monitoring panel after server 


initialization. Figure 11 shows the intentional user interface preview. 


PFTP Server 


Menu bar 


Control Panel 





Figure 11. | Preview of the server’s user interface in PFTP application 


b. File Transfer 

The file transfer from the PFTP Server to the PFTP Client results from a 
client-side user request. The user selects the preferred features of the file transfer (file 
name, PFTP server, packet size), and asks to download it. The server sends the file as 
packets (arrays of bytes) that the client collects until it receives all of them. The client 
application keeps track of the number of packets received, and in case of a failure in the 
connection, keeps attempting to reconnect with the server and send a request to retrieve 


the rest of the file packets. 
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c. File Database 

The server of this application must keep a file database to store the files 
available to the clients for transfer. The server cannot start unless the user first adds files 
to the database. Any file can be removed at any time from the database but the 
application stops running when the database becomes empty. Client-side user is advised 
when the server file database is empty. 

d. File Authentication 

After a connection failure and during the reconnection period, the client 
will request the same file either from the same or another PFTP server. In order for the 
server to know if it has the right file (same name, modification, or content) with this 
name, it must use a value that uniquely identifies it. A hashing algorithm such as MD5 
can produce a hash value for the file that is sufficient for this authentication check. That 
value will be sent by the server to the client after the initial file request, so that it can be 
available later, to be included in the partial file recovery request to another PFTP server, 
in the event of a connection loss. 

e. PFTP Server Availability 

PFTP client-side keep a list of the PFTP server IP addresses to try during 
the reconnection. For better performance a getServer() function should be called that can 
search for a valid server to connect to, which is beyond the scope of the thesis research 
Also, the client-side user can add any additional PFTP server available at a later time. 

f Client-Server Communication Protocol and User Interaction 

PFTP is an application layer protocol and it is based on a client-server 
communication scheme. For the file transfer process, an application layer communication 
protocol must be established. The TCP protocol is the underling protocol for every 


connection and data transfer between the client and server (Figure 12). 








PrP ei PFTP 
Client Server 


Communication protocol 




















Figure 12. The communication scheme of PFTP application 
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This communication protocol is shown in Figure 13 and starts with the 
PFTP server running and waiting for clients at port 6789. When the user opens the PFTP 
client application, it must choose a PFTP server manually or from a list of already 
existing servers in order to retrieve the list of files available for transfer. In the predefined 
server case, an Auto server mode option exists which can be selected when the user wants 
the application to choose a predefined PFTP server randomly during either the initial 
available file retrieval or the partial file retrieval process after a connection loss. When 
the file list is retrieved, a user selects a file name and the packet size and forms a file 


request packet that is sent to the server. The request packet fields are shown in Figure 14. 





Request File 


File Name Offset Packet Size 
Type Name 


File Request Message: 






































Figure 13. The communication scheme of PFTP application 


The server checks if it has the file and, if it does, sends the file size and the 
hash value of the file back to client. Then the server starts reading the file data and sends 
it in packets to the client. If, during the packet transmission, a connection failure occurs, 
the client side generates partial-file-request packet, setting the offset field value with the 
next expected packet counter and the hash field value with the file hash received at the 
start of the file transfer. Then, the client attempts to reconnect with the same server or, if 
the Auto server mode selected, with the next available PFTP server, and when it is 


connected, sends the prepared partial-file-request packet. 
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PFTP Client 
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User selects a server to 
rereive the files that are 

available to transfer 
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transfer features. 
Ask for the file. 
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receive file 
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Receiving 
file 
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hash value 
in the file request packet 
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Receiving 
file 
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Receive all the 
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Send the file list 
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e hash value and the file size 


Sending file packets 


Sending file packets 


Connection lost 


Connect to server 


Send the partial file request 


PFTP Server 


Server is running 
Waiting for clients 


Server replies 
sending the 
available file list 


Server check if 

has the file and 

| __* | compute the file 
hash value. 


Start sending 
the file packets 


Close connection 


Server checks if 
has the file with the 
same hash and 
continue to send 
the rest of the file 
packets. 


Close connection 





Figure 14. |. The communication protocol of PFTP application 


The server that receives the packet, if the offset value is greater that zero, 
checks if it has the same file with the same hash value and continues sending the 
remaining data in packets to the client. Each file connection loss causes the same partial- 
transfer retrieval scheme until the client receives all the file packets and both the client- 


and server-sides close the connection. 
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2. Non Functional Requirements 


a. User Requirements 

The user of the client-side application must have some experience using 
the graphical user interface window on a desktop, a laptop and Pocket PC devices; using 
a mouse or stylus to select items from a drop down list; pressing the buttons; and exiting 
an application by closing its window. Also, the user must possess at least minimal 
network technology knowledge to understand how the client-server concept works. This 
includes information such as that the server program must be running first so a client can 
connect to it. The system will then help the user by providing sufficient information in 
the Transfer Status Panel and by using message windows. The knowledge as to how a 
network connected device can be set up must be available. 

b. Hardware 

The PFTP application does not require any exceptional computational 
power in both the desktop/laptop and the Pocket PC version. Some minimal system 
requirements are: 


e PFTP Server: Pentium IIT 500 MHz processor,128 MB RAM, Network 
Interface Card, a static IP address (no DHCP). 


e PFTP Client (desktop/laptop): Pentium HI 500 MHz processor, 128MB 
RAM, Wireless Network Interface Card 


° PFTP Client (Pocket PC): Pocket PC ARM compatible handheld, 16MB 
of RAM, 802.11b wireless adapter 


c Software 
The following software must be present so the PFTP application can run 
properly: 


e PFTP Server: Windows 98, NT, 2000 or XP operating system and a Java 
Virtual Machine. 


e PFTP Client (desktop/laptop): Windows 98, NT, 2000 or XP operating 
system, Java Virtual Machine and the Java 2 SDK 1.4 installed. 


e PFTP Client (Pocket PC): Pocket PC 2002 or greater and a Java Virtual 
Machine, such as Jeode JVM, installed. 
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B. UML DIAGRAMS 
1. Use Case Diagrams 
The basic actors of the PFTP application are the users of the client-side 
and the server-side user interface, as well as the client and server systems. Figure 15 


demonstrates the possible use cases that the user interface allows: 


e The server user adds a file to the server’s file database 

° The server user removes a file from the server’s file database 

e The client user asks for a file from the server for the first time 

e The client user decides to cancel the file transfer without saving any data 


already transferred 


e The user decides to retrieve a partial transferred file at a later time 





PFTP Application 





Add a file in file 
database 






PFTP Server User Server 


PFTP Clisgt Use PE YA Client 


Continue a previous 
partial file transfer 


Figure 15. The use case diagram of the PFTP application 
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Zz; Class Diagrams 
a. User Interface Classes 
Figures 16, 17 and 18 show the class diagram of the PFTP client for the 
desktop/laptop, the Pocket PC and server versions. The user interface for this client-side 
version is a main frame that contains four panels to control the client and monitor the 
progress of the file transfer. All the panels except the control panel start by the initiation 
of a file transfer. After the file is transferred, all panels reset for the next file transfer 


request. 
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Figure 16. 


PFTPClient 


-container : Container 

-layout : GridBagLayout 

-constraints : GridBagConstraints 
-transferProgressPanel : TransferProgressPanel 
-transferStatusPanel : TransferStatusPanel 
-imagePr ogressParel : ImageProgr essPanel 
-filelsTransfering : Boolean 

-askTheFile : Boolean 

-cientSocket : Socket 

-outObjectToSer ver : Object OutputStream 
-inObjectFromServer : ObjectOutputStream 
-fileRequest : PFT PFileRequest 
-oldPartialTr anfer Request : HashMap 
-ddPartialTr ansfersBytes : HashMap 
-oldPartialTr ansfer sFiles : ArrayList 

-server AvailableFiles : ArrayList 


-offset : int 
-packetSize : int 
-fileInBytes : byte [] 
-packetCounter : int 

: int 


-totalFileTransferTime : long 
-connectionStatus : String 
-connectionLossT imes : int 
-wantFile : Boolean 

-file Transfered : Boolean 
-cancelFileTransfer : Boolean 
-retrieveFailedTransfers : Boolean 
-partialRetrievedFileName : Boolean 


() 
+selectServer() : String 


+getSer ver AvailableFiles() : ArrayList 
+askForFile() 

+cancelFileTransfer() 

+setF ileNameToAsk() 
+setAskTheFile( 
+setServerMode() 
+setPacket Size ( 


leNameToAsk() : String 
+getSer verMode() : String 
+getPacketSize() :int 
+getOffset() :int 
+getFileSize() :int 
+getNumOfPackets() :int 
+getReceivedPackets() :int 
+getFileInBytes() : byte[] 
+getConnectionStatus() : String 
+getConnectionLossTimes() : int 
+getT otalFileTr ansfer Timeg)) :int 
+getFileTransfered() : Boolean 
+getContr olPanel() : ControlPanel 
+getT itledPanek ) : JTextPane 
+savePartialFileRequest() 
+deletePartialF ileRequest() 
+resetApplication () 
+startCheckToAsk() 

+delay() 











PFTPClient::ControlPanel 


-controlPanelClient : PFTPClient 

-progr essPanel : TransferProgr essPanel 
-statusPanel : Transfer StatusPanel 
-imagePanel : ImagePr ogressPanel 
-controlPanelTitle : JPanel 

-fileC hoiceDialog : FileSelectionDialog 
-fileC hoiceField : TextField 
-serverModeChoiceBox : JComboBox 
-packetSizeChoiceBox : JComboBox 
-fileButtonGr oup : ButtonGr oup 
-serverButtonGroup : ButtonGroup 
-previousFailedFiles : JRadioButton 
-filesFromSer ver : JRadioButton 
-manualServerSekection : JRadioButton 
-predifinedServerSelection : JRadioButton 
-selectServer : JButton 
-retrieveAvailableFiles : JButton 


-serverlPs : String] 

-packet Sizes : String] 
-fileSelection : String 
-serverSelection : String 
-packet SizeSelection : String 
-fileSelected : Boolean 
-serverSelected : Boolean 
-packet SizeSelected : Boolean 


+setFileSedlected () 
+reset() 


PFTPClient :TransferStatusPanel 


-transferStatusPanelClient : PFTPClient 
-transferStatusPanelTitle: JText Pane 
-fileAskedInfo : JTextPane 

-fileSizelnfo : JTextPane 
-packetSizeUsedInfo : JTextPane 
-connectionStatusInfo : JTextPane 
-connectionLossTimesinfo : JTextPane 
-totalT ransferT imel nfo: JTextPane 


+updateFile Transfer Status{) 
+reset() 


PFTPClient::TransferProgressPanel 


-transferProgressPanelClient : PFT PCiient 
-downloadMessagePandi : JPanel 
-downloadMessage : JLabel 
-progressBarPandi : JPanel 
-progressBar : JProgressBar 
-downloadPer centagePanel: JPanel 
-downloadPer centage : JLabel 
-fleToTransfer : String 

+setProg essBarMax() 
+updateProgressBar{ ) 

+reset() 


PFTPClient::imageProgressPanel 


-imageProgressPanelClient : PFT PClient 
-imageProgressLabel : JLabel 











-updatedTimes: int 
-fileNameToPreview : String 
+updatelmageProgress() 
+reset() 





The class diagram of the PFTP Desktop/Laptop Client user interface 


PFTPClientPPC 


-outObjectToSer ver : ObjectOutputStream 


-fileRequest : PFTPFileRequest 
-oldPartialTr ansfer sRequests : Vector 
-oldPartialTr ansfer sBytes : Vector 


-oldPartialTr ansfer sFiles : Vector 
-ser ver AvailableFiles : Vector 


-fileNameToAsk : String 
-ser verMode : String 
-fileHash : String 


-fileSize : int 
-offset : int 1 





-packetSize : int 
-filelInBytes : byte[] 


-packetCounter : int 


-connectionStatus : String 
-connectionLossTimes : int 

-messageOption : String 

-wantFile : Boolean 

-fileTransferred : Boolean 
-cancelFileTransfer : Boolean 
-retreivefeiledTransfers : Boolean 
-PartialRetreivedFieName : String 
-container : Container 

-controlPanel : ControlPanel 

-imagePr ogressPanel : ImageProgr essPand 
-filelsTransferring : Boolean 1 
-askTheFile : Boolean 


() 
() : String 
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+cancelFileTransfer( ) 
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+resetAppiication () 
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PFT PClientPPC::FileSelectionDialog PFTPClientPPC ::FrontDialog 


-dialogClient : PFTPClientPPC 
-dialogContr olPanel : ControlPanel 


-dialogButton : Button 


-dialogSelection 


Figure 17. 





-dialogClient : PF TPClientPPC 
-dialogcontrolPanel : ControlPanel 


-dialogTextField : Label 


-imageCanvas : PFTPCanvas 
-imageCanvasDimension : Dimension 
-useltButton : Button 


sits a 


-controlPanelClient : PFT PClient PPC 
-imagePanel : ImagePr ogressPanel 
-contro|lPanelTitle : Panel 
-file ChoiceDialog : FileSelectionDialog 
-fileChoiceLabel : Label 
-serverModeChoiceList : List 

i : List 


-serverButtonGroup : CheckboxGroup 
-previousFailedFiles : CheckBox 
-filesFromSer ver : CheckBox 
-manualServerSelection : CheckBox 
-predefinedServerSelection : CheckBox 


-fileSelected : Boolean 
-serverSelected : Boolean 
-packet SizeSelected : Bodean 


+setFileSelected () 
+reset() 





PFTPClientPPC::ImageProgressPanel 


-imageProgressPanelClient : PFTPClient PPC 
-imageCanvas : PFT PCanvas 


-imageCanvasDimension : Dimension 
- updatedTimes : int 
-fileNameT oPreview : String 


+update ImageProgress{) 





1 
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PFTPCanvas 


-canvasimage : Image 





PFTPClientPPC:: Message Dialog 


-dialogClient : PFTPClientPPC 
dialogTitle : String 
-dialogTextField : Label 
-dialogButton : Button 
-~messageT ype : int 
-dialogMessage : String 





The class diagram of the PFTP Pocket PC Client user interface 
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PFTPServer 


PFT PServer. :PFT PServerSt at usPanel 


-serverStatusPanedServer : PFT PServer 
-serverStatusPaneTitle : JTextPane 
-numberOfcurrentclientsI nfo : JText Pane 
-numberOfT otal Transfersinfo: JText Pane 
-percentageOfT ransferF ailuresinfo: JTextPane 

-numberOfCurr entClients : int -numberOfLocalFilesInfo : JTextPane 
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-numberOfTransferFailures : int +updateServerStatud) 
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-numberOfLocalFiles : int 
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-addFileltem : JMenultem 
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Figure 18. The class diagram of the PFTP Server user interface 
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PFTP Client GUI 






b. Desktop/Laptop PFTP Application Version 


PFTPClient 


-tr ansfer ProgressPanel: TransferPr ogressPanel 


-tr ansfer StatusPanel : TransferStatusPanel 
-imageProgressPanel : ImageProgressPanel 
-filelsTr ansfer ing : Boolean 

-askTheFie : Boolean 

-clientSocket : Socket 

-outObjectT oServer : ObjectOutputStream 
-inObjectFromServer : ObjectOutput Stream 
-fileRequest : PFTPFileRequest 
-oldPartialTranferRequest: HashMap 
-oldPartialTransfersBytes : HashMap 
-oldPartialTransfersFies : ArrayList 
-serverAvailableFiles : ArrayList 
-fileNameToAsk : String 

-serverMode: String 

-fileHash : String 

-fileSize : int 

-offset : int 

-packetSize : int 

-filelnBytes : byte] 

-packetCounter : int 





-totalFileTransferTime : long 
-connectionStatus : String 
-connectionLossTimes : int 
-wantFile : Boolean 

-fileTransfered: Boolean 
-cancelFileTransfer : Boolean 
-retrieveFailedTransfers : Boolean 
-partialRetrievedFileName: Boolean 


() :String 
+getServerAvailableFiles() : ArrayList 
+askForFile() 


+getNumOfPackets() : int 
+getReceivedPackets() : int 
+getFileInBytes() : byte[] 
+getConnectionStatus() : String 
+getConnectionLossTimes() : int 
+getTotalFileTransferT imes{) : int 
+getFieTransfered) : Bookan 
+getControlPane() : ControlPanel 


+getTitledPanel() : JTextPane 


Figure 19. 
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PFTPServer 


ieMap : AvailableFieMap 
-4ieNamesinMap : ArrayList 
-startListening : Boolean 
-exitApplication : Boolean 
-numberOfCurrentCients: int 
-numberOfTotalTranfers: int 
-numberOfTransferFailures: int 
-percentageOFtransferFailures : double 
-numberOfLocalFiles : int 

-statusPanel : PFTPServerStatusPanel 
-startSer ver Item : JMenultem 

ieMenu : JMenu 

-startSer ver Item : JMenultem 
-stopServerltem : JMenultem 
-addFikltem : JMenulten 
-+removeFileltem : JMenultem 
-deleteFileFrame : JFrame 


+setNumberOfCurrentClients() 
+setNumberOfT otalTransferg) 
+setNumberOfTr ansfer Failureg ) 

+set PercentageOfTransferFaiured) 
+setNumberOfLocalFiles() 
+getNumberOfCurrentCientg) : int 
+getNumberOfTotalTr ansfer) : int 
+getNumberOfTransferFailureg) : int 
+getPercentageOfTransferFailured) : int 
+getNumberOfLocalFiles() : int 


PFTPServer::ClientHandler 


-lientSocket : Socket 
4nObjectFromClient : Object! noutStream 
-outObjectToClient : ObjectOutputStream 
+equest : PFTPFileRequest 
ilesAvailable : Vector 
+equestType : int 
4ileName : String 
4ileHash : String 
-packetSize : int 
-offset : int 
numOfBytes : int 
+run() 
+openStreams{) 
+handleF ileRequest() 
+closeConnection () 
+getHashValue() : String 

) : Boolean 


The class diagram of the PFTP application 


PFTP Server GUI 


é. Pocket PC PFTP Application Version 
The main difference with desktop/laptop version is that in Pocket PC the 


classes that were used are less in number because lower version of JDK (1.1.8) is 


appropriate to use for these devices. 


PFTP ClientPPC GUI 


Figure 20. 





PFT PClientPPC 





| clientSocket : Socket 
tinObjectFromServer : ObjectInputStream 
+ outObjectToSer ver : ObjectOutputStream 
| fileRequest : PFTPFileRequest 

| oldPartialTr ansfer sRequests: Vector 
dPartialTr ansfer sBytes : Vector 
dPartialTr ansfer sFiles : Vector 

| server AvailableFiles : Vector 

| fileNameToAsk : String 

+ server Mode : String 

| fileHash : String 

| fileSize : int 

| offset : int 

| packetSize : int 

| fileInBytes : byte[] 

t packetCounter : int 

fnumOfPackets : int 

| startTime: long 

| stopTime : long 

| totalfile TransferTime : long 


ol 
ol 











| fileTransferred: Bodlean 

| cancelFileTransfer : Boolean 

| retreivefeiledTransfers : Boolean 
| PartialRetreivedFileName : String 


O-—- container : Container 


t controlPanel : Contr olPanel 


| filelsTransferring : Boolean 
TaskTheFik : Bookan 


timageProgressPanel : ImageProgr essPanel 





+ openStreamg) 

| selectServer() : String 

| getServerAvailableFiles() : Vector 
H-askF or File() 

-cancelFieTr ansfer () 
H-setFileNameToAsk() 
l-setaskT heF ile () 
+-setServerMode() 
}-setPacketSize () 

t-SetOff set () 

+-getServerMode() : String 

H-getF ileNameToAsk() : String 
}-getPacket Size () :int 

H-getF ileSize () :int 

H-getN umOfPackets () : int 

-getR eceivedPackets () :int 
}-getFilelnBytes() : byte] 

H-getC onnectionStatus() : String 
-getC onnectionLossTimes() : int 
t-getT otalFileTransferTime() : long 
}-getFileTr ansferred() : Boolean 
}-getC ontrolPanel() : ControlPanel 
-resetApplication () 

l-Star tCheckT oAsk() 

delay () 



























PFTPServer 





-serverSocket : ServerSocket 
-mainSocket : Socket 

-fis : FilelnputStream 

-fileMap : AvalableFileMap 
-fileNamesinMap : ArrayList 
-startListening : Boolean 
-exitApplication : Boolean 

-number OfCurrentClients: int 

-number OffotalTranfers: int 

-number OffransferFailures: int 
-percentageOFtransferFailures : double 
-number OfLocalFiks : int 

-statusPand : PFT PServerStatusPanel 
-startServerltem: JMenultem 

-fileMenu : JMenu 

-startServerltem: JMenultem 
-stopSer ver Item : JMenultem 
-addFileltem : JMenultem 
-removeFileltem : JMenultem 

-deleteF ileFrame : JFrame 


+o ~PFTP Server GUI 





+setNumberOfCurrentClents() 
+setNumberOfTotalTransferg) 
+setNumberOfTr ansfer Failureg ) 

+set PercentageOfTransferFailures) 
+setNumberOfLocalFiles () 
+getNumberOfCurrentClientg) : int 
+getNumberOfTotalTr ansferg) : int 
+getNumberOfTransferFailureg) : int 
+getPercentageOfTransferFaiureg) : int 
+getNumberOfLocalFiles() : int 





+t connectionStatus : String +startListening () 

-connectionLossTimes : int +delay() 

| messageOption : String +selectFile () : File 

twantFile : Boolean +removeF rom Database ) 1 














+getCapacity() :int 
+setCapacity() 
+hasFile() : Boolean 
+getFileBytes() : byte [] 
+addFile() 

+removeF ile() 





PFT PServer: ClientHandler 


-clientSocket : Socket 
4nObjectFromClient : ObjectInputStream 
-outObjectToCiient : ObjectOutputStream 
+equest : PFT PFileRequest 
4ilesAvailable : Vector 

+equestType : int 

fileName : String 

ileHash : String 

-packetSize : int 

-offset : int 

-numOfBytes :int 

+run() 

+openStreamd) 

thandleFileRequest () 
+closeConnection () 

+getHashValue() : String 

+checkHash () : Boolean 

+sendFile() 




























The class diagram of the Pocket PC PFTP Application version 


3; Activity Diagram 
Figure 21 shows the activity diagram for the PFTP application. 




















Start state: PFTPClient started Starting state: PFTPServer runs 























[User start the server] 
[User ask file list from server ] 


File list retr eived from server 


















Server startedwaiting for clients 








[User select file transfer options] 


Fik list retreived 


[Client user ask the file transfer ] 


[Send the file list and disconnect ] 






[Accept client connection] 






Client trying to connect to the server 


[Tries <= maximum tries] 


Server ready to send file list 














[Client doesn't manage to connect] 
[Receive file list request ] 
[Cliert manage to connect] PA 
Vv 
PFTPClient connected with the ser ver [Auto Server ie Server connected with the cient 





[Send the file request to the server] [Receive the file request] 










Aly . 
[The right file doesn't exist at servar] [Right fle doesn't exist] 


0 







[The right file exist at server] [Right file exists] 


Vv 


Client start receiving the the file packets 


[Receiving file packets ] 


IFilp transferred interr =e 


[File transferred isn't interr upted] 








Server start sending file packets 





[Send file packets] [Close connection] 











[Fie transferred interrupted 


[File transferred isnt interrupted] 










Fike transferred not possible File trasferred 





File Transferred 


[close connection ] 








[Close connection] [Close connection 
Server disconnected 


Client Disconnected 
{Server administator leave the server offen] 


[Ask the user for more transfers] > 












[Server user stop the server] 


Ibsen want more transferg . 
[Server administr ator close server] 


[User doesnt want any transfer 
Close the connection] 





























® Final state: Client closed Final state: Server closed 




















Figure 21. The activity diagram of the PFTP application 
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4. Flow Sequence Diagrams 
The flow sequence diagrams that follow show the order of the interactions 
between the PFTP application objects during each use-case (mentioned in §B.1) for both 


versions of PFTP clients (desktop/laptop and Pocket PC). 


a. Add a File in Database 


:PETPSer ver :JFile Chooser ‘AvailableFileMap 






new JFileC hooser() 







get SelectedFile() 


addFile( file Selected ) 


put(fileSelected) 


Figure 22. The sequence diagram of “Add a file in database” use-case 
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b. Remove a File from Database 


:PETPServer :DeleteFileFrame -AvailableFileMap 









new DeeteFileFrame( ) 









set Visible (true) 


removeFile(fieName) 


remove(fileName) 


setVisible (false ) 


Figure 23. The sequence diagram of “Remove a file in database” use case 
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é. Transfer a File 


:PETPServer :ObjectInputStream || :ObjectQuputStrean :PETPFileRequest 





serenade 
| 
selectServer() 


| 
getServerAvailableF iles() 


WV 


Il 
new ObjectInputStream() 
new ObjectOutputStrean() 


( 
I 
( 
! 
I 
( 
I 
( 
i} 
I 
( 
I 
Et — — hh new ClientHandler() Of | 
at eR | 
| > rund 
new ObjectInputStream() aa openStreams() 
Inew ObjectOutputStream( 
ae handleFie Request() 
new PFT PFileRequesifileListOption ) 


write Object (fileListRequest ) La 


readObject () 


readObject () t writeObject(fileList) 


SS coseConnection () 
ee as rFifeNae 
new ObjectInputStream() 


———i new ClientHandler( | 
es ee ee | 


new ObjectOutput Stream() 





getRequestType() 


closeC onnection() 


7 












run() 


= 
ee openStreams‘() 
—_ 


new ObjectOutputStream() 
handleFileRequest() 
new i 4 fileTransferOption) 






| ___wrtebject fleRequest) (fleRequest)| | 


| () 
readObject() writeObject(filePacket) 
| eadObiect) writeObject(filePacket) 
readObject() writeObject(lastFilePacket) 


getRequestType() 













| WrteBooleanttruc) 7 


reaBoolean() 


| > closeConnection () l hee closeC onnection() 


Figure 24. The sequence diagram of “Transfer a file” use-case 
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d. Cancel File Transfer and Save Partial Data Use Case 


:PETPClient 


PFTPProtocok:PFTP Client User 
1 
I 
( 
1 


cancelFileTransfer() 


savePartialFileRequest (failedRequest) 


Figure 25. The sequence diagram of “Cancel file transfer and save partial data” use case 


3D 














Figure 26. 


:ObjectInputStream || :ObdjectOQuputStream :PFT PFileRequest 
( 
J ' 
J 
( 
I 
( 
J 
J 
( 
new ObjectOutputStream() 
I 


readObject() 
readObject() writeObject (file Packet) 
readObject() writeObdject (fle Packet) 
e 
e 
writeObject(lastFilePacket) 


e. Continue a Previous Partial File Transfer 


( 
| 
era 
selectPartialFileRequest() 


askForFile(partialRequestFileName) 


new ObjectinputStream() 






new CiientHander‘() 
start() 














run() 
new ObjectOutputStream() openStreams ) 
new ObjectOutput Stream () 
handleFiRequest() 





new PFTPFileRequest(par tial File TransferOption) J 





writeObject(partialFile Request) 





getRequestT ype( ) 











| 






reaBoolean() 


closeConnection () closeConnection() 


The sequence diagram of “Continue a previous partial file transfer” use case 
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IV. APPLICATION DEVELOPMENT 


This chapter describes the development tools used to build the PFTP application 
and some development decisions were made during the implementation of some 
application components such as the user interface and the client-side and the server-side 


programs. 


A. DEVELOPMENT TOOLS 

The PFTP application is written using the Java programming language. For both 
the server-side and the laptop client version, the Java 2 Standard Edition (J2SE) with the 
Java Development Kit 1.4 (JDK 1.4) was used. In the Pocket PC client version, the Java 
Development Kit 1.1.8 (JDK 1.1.8) was used because handheld and mobile devices 
cannot support the functionality provided by greater versions of JDK. The Java code was 


developed in the JBuilder 9 Java Editor environment. 


B. USER INTERFACE 

1. PEFTP Server 

The server side of the application has a limited-functionality user interface so that 
the user can perform some basic operations such as starting and stopping the PFTP 
server, and manipulating the database where the files reside for the clients to download. 


Figure 27 shows the first interface that the user sees when the server program runs. 


—~ 


“S PFTPServer Bele 





SPpFTP 





Figure 27. _ User interface of the PFTP Server application 
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There is a menu bar with two menu items. The Server menu item gives the user 
the ability to start the server (start listening to the assigned service port), stop the server, 


or exit the application (Figure 28). 


Start server 
Stop server 


Exit 


it ——_ 








Figure 28. User interface when the Server menu item is selected 


If the server is started by the user, in the main frame, a server status panel appears 
that shows how many clients are connected to the server, how many file transfers have 
occurred since the server started, how many of the file transfers failed, and how many 


files are available in the database for download (Figure 29). 


SERVER STATUS 


Current clients : 


Total file transfers : 


Transfer failures : 


Files in database : 





Figure 29. User interface when the server starts 


The Database menu item can be used by the user to update the server file 
database by adding or removing files (Figure 30). Before the user can start the server, the 


user must first add files to the database to be available for the client. 


38 


Q 
SpETP 





Figure 30. _ User interface when the Database menu item is selected 


Selecting the add or remove file option from the Database menu item, the user can 
browse among the local directories using a popup file dialog (Figure 31) and select the 
file to add or remove from the server database, respectively. The server’s file database 


does not store the files as a file objects, but rather as individual byte arrays. 


_L) PFIPjpx.tocal 
[) PFTP,jpx.local~ 
[\ PFTP.jpx~ 
PFTPLogo 
Ty downloadArrow Ty PFTP PFTPserver 


File Name: imap1 GIF 
Files of Type: | All Files ¥ | 


Add Cancel | 


Figure 31. User interface when the Database menu item is selected 
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2. PFTP Client 









[= DFTD Laptop 1.0 





Select packet size + 






ancoal Lawninad 











ab Sperp 











Te 
Petiwel” Brown. | Mxuco,, | diate. 
— ee eee eee 


Figure 32. The user interface for the client side in the desktop/laptop version 


Enter server IP 


Select the server 


Petreive files. 


|Packet eee, 
[ Download Cancel Dowrlour! 


fF\PFTP PocketPC FR] - é 11:13 





Figure 33. The user interface for the client side in the desktop/laptop version 
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C. FUNCTIONALITY IMPLEMENTATION 

1. File Transfer Failure Recovery 

The main functionality of the application is to reconnect the client program when 
the connection is lost during the file transfer process. The implementation for this feature 
was based on a loop that the client enters when a file is requested from the server. This 
loop ensures that the client will keep connecting until it gets the entire file. The control 
conditions of the loop are: 


e The file transfer completion. If the entire file is successfully transferred 
the client exits the loop. 


e The option of the user to cancel the file transfer. If the client user decides 
to do so, the loop is ended. 


e The number of times the client has already tried to recover from the 
connection loss. If this number is greater than the maximum allowed 
number of tries, the loop terminates. 


2. File Authentication 

For the file authentication check performed by the client and the server, the 
default MD5 algorithm was used to get the file hash value. Then the hash value is 
converted to a string so that it can be easily exchanged during the communication 
protocol. Figure 34 shows the code segment getHashValue() used to produce the file hash 


value. 
[** 


* Compute the hash value of a given file 


k 


* @param fileName the name of the file 
* @return the String representation of the file hash value 
sa 

public String getHashValue( String fileName ){ 


String theHash = null; 


try{ 
File theFile = new File( fileName ); 


fis = new FileInputStream( theFile ); 


4] 


byte[] buffer = new byte[8192]; 
int length; 
//Select the MDS hash algorithm 
MessageDigest md = MessageDigest.getInstance( "MD5" ); 
while( ( length = fis.read( buffer ) ) != -1 ){ 
md.update( buffer, 0, length ); 
} 


fis.close(); // Close the file stream to free the file 


// Final computation of the hash 
byte[] hash = md.digestQ); 


// Create a String version of the hash value using the default 
// 64bit Character encoding algorithm. 
BASE64Encoder encoder = new BASE64Encoder(); 


theHash = encoder.encode( hash ); 


} catch( FileNotFoundException fnfe ){ // In case file not found 
System.out.println( fnfe ); 
theHash = new String( "fileNotFound" ); 

} catch( Exception e ){ // In case there is problem 
System.out.printIn( e ); // with hash computation 


theHash = new String( "hashProblem" ); 
} 


return theHash; 


} //end getHashValue() method 


Figure 34. Code segment to produce the file hash value 
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Vv. TESTING 


This chapter describes to the testing process of the PFTP application, including 


the test network description, the various scenarios that were used, and the general results 


of the testing. 


A. TESTING NETWORK DESCRIPTION 


The testing of the PFTP application required the installation of a basic wireless 


network that simulates a real situation in which all the application components’ 


operations can be tested against several scenarios. 


di, 


2. 


Considerations-Limitations 


The NPS wireless network was used to test the mobile PFTP clients 
The IP addresses of the PFTP server must be static. 


The number of wired servers and wireless enabled devices used to build 
the test network, were sufficient to test the requirements of the thesis 
research and not to test the volume of client traffic that the application can 
handle 


In the most of the testing scenarios, a “slower” version of the PFTP is 
used. That means the server’s and client’s program response was slowed 
with the use of a “delay” function so that it is easier for the user to observe 
the communication protocol features and behavior during the test 
scenarios. 


The desired connectivity failures necessary to test the protocol responses 
were manually caused by either unplugging the network connection in the 
wired devices (mainly servers), or by disabling or removing the wireless 
adapters from the wireless enabled mobile client devices (laptop, 
PocketPC). 


Testing Network 


As Figure 35 shows, the testing network consists of three PFTP servers, each a 


wired device, part of the NPS network, one or both wireless enabled laptop and Pocket 


PC devices running the appropriate PFTP Client version software. 
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™ 
Pocket PC PFTP Client P 
— 








Laptop PFTP Client 








Figure 35. The testing network of PFTP application 


B. TESTING SCENARIOS 

Several testing were developed to emulate the various problems that might be 
encountered by a wireless device while downloading a large file. These scenarios assured 
that the purposes of the thesis research were fulfilled. Table 2 lists all the testing 
scenarios associating them with a reference code so that they can be referred to the results 
description without naming them explicitly. The reference codes start with a group of 
letters that indicates the general scenario type and ends with a counter number. The 
reference code part that refers to the scenario’s type is one of the following: 


e SUIS: Server User Interface Scenario. Situations that can happen during 
the interaction of the PFTP Server’s user with the available user interface. 


e CUIS: Client User Interface Scenario. Situations that can happen during 
the interaction of the PFTP Client’s user with the available user interface. 


° CPS: Communication Protocol Scenario. Situations that can happen 
during the communication between the client and the server. 
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Scenario Reference Code 


Scenario’s description 









































SUIS-1 Starting the server without adding files in the database 

SUIS-2 Trying to remove a file from the database when it is empty 

SUIS-3 Entering the same file twice into the database 

CUIS-1 Selecting to continue a previously failed file transfers when 
one is not an associated file saved 

CUIS-2 Trying to download a file without selecting all the necessary 
file transfer options 

CPS-1 The PFTP server is not reachable when the available files are 
requested and the single server mode is selected 

CPS-2 The PFTP server is not reachable when the available files are 
requested and the auto server mode is selected 

CPS-3 During the file transfer, the connection is lost but is restored 
again after a short period of time. The single server mode is 
selected. 

CPS-4 During the file transfer, the connection is lost but is restored 
again after a short period of time. The auto server mode is 
selected. 

CPS-5 During the file transfer, the connection is lost but is restored 
again after some period of time. The auto server mode is 
selected and all the other servers except the first one selected, 
have the same named file but contain different content. 

Table 2. The testing scenarios for the PFTP application 
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If the server has been started by the user, the main frame of the server’s status 
panel appears in that shows how many clients are connected to the server, how many file 
transfers have occurred since the server started, how many of the file transfers failed, and 


how many files are available in the database for download (Figure 3). 


C; TESTING RESULTS 

The following paragraphs explain how the network components responded to 
each of the scenarios and how the user interface helped the user be informed if a file 
transfer failed during its operation. The reference codes listed in Table 1 are used to refer 
to each scenario. 


e SUIS-1. The scenario tries to determine if the PFTP server starts listening 
to the assigned port without having any files available for the clients to 
download. The result was that the program informed the user via a 
message to add at least one file to the server’s file database such that the 
server has a reason to start listening for clients (Figure 2). 


> DETI m 
Server Database 


Can't start 





= . You must add files to server database 
7 iy before you start the server! 





Figure 36. The response of server side in the SUIS-1 scenario 


e SUIS-2. The same situation as the previous but this time tested function is 
an attempt to remove a file from the empty database. When the database is 
empty, the selection of the user to remove a file caused a message to 
appear informing the user about the database’s status (Figure 37). 
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& PFTPServer = || LJ Es 


Server Database 


Gy No file available in database 





Figure 37. The response of server side in the SUIS-2 scenario 


Figure 38. 


SUIS-3. Trying to add a file to the file database that has the same filename 
as an existing one, is another tested case. In this scenario, the response of 
the server program was to ask the user to choose between replacing the 
existing file with the new one or leaving the old file in the database 
(Figure 38). 





> PF TPServer aan Eg 


Server Database 


File exists! | 


The file already exists! 
Do you want to overwrite it? 





The message when a already existing file is added in file database 


CUIS-1. The user interface gives the user the ability to select to continue a 
previously failed file transfer, saving the partial data to a form in the 
database. However, when no failed transfers have occurred, the selection 
of the previous file retrieval mode causes the system to respond with a 
message that states this (Figures 39 and 40). 
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®) Previous failures () PFTP Server files 


* ©) Manual Selection ®) Existing Servers 


Enter server IP 


No file transfer failure by now! 


Select a file from the PFTP servers. 
Select server 


No file selected 





Figure 39. The message when no previous partial file transfer exists 


PFTP PocketPC 1.0 jaa [ra] x | 


CONTROL PANEL 


File to retreive: © Failed transfers 
@ Citas an snvune 


** Message ** 


No file transfer failure by now! 


7 


fetreive files. 


File selected : No file selected 


| Download Cancel Dowrnlogecl 


Tr 


EF |PFTP PocketPC: FA - 4< 9:10 








Figure 40. The same message as Figure 5 in Pocket PC device 
e CUIS-2. In this scenario, the user presses the download button, without 


first selecting all the transfer options such as the file name, the server, or 
the packet size. The system informs the user to do so (Figures 41 and 42). 
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& Please select server, file and packet size first! 


ma 





Figure 41. The message when not all the file transfer option are selected 


PFTP PocketPC 1.0 |_| x, 


CONTROL PANEL 

File toretreive: @ Failed transfers 
© Files on server 

** INFORMATION ** cS 


Select file and packet size! 


xa 


| etree WES... 


File selected : No file selected 


Download Cancel Doywrlogel 


f7|PFTP PocketPC: FY - << 9:42 





Figure 42. The same message as Figure 7 in Pocket PC environment 


e CPS-3. This is the main function of the PFTP application-recovering from 
a failed connection. During the file transfer, the connection is interrupted 
and the client attempts to the server in either single and or manually 
selected server mode. The image progress panel of the user interface, 
which displays the image download progress, stops updating until the 
client reconnects to the server and begins retrieval of the rest of the file. 
Figures 43 and 44 show the paused state of the user interface during 
connection failure and Figure 45 the attempt of the client program to 
connect to the server. Figures 46 and 47 show the message when the file is 
finally transferred, followed by the amount of time the transfer required. 
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CONTROL PANEL 


Fit w lomeive 
Server ta tmceten thorn 
Adlé Sere & 
Chipase server mate: 


Fie selects : 


TRANSFER PROGRESS 


DN raew af Gap mae hot 
Downeoting fae maga OF 


TRANSFER STATUS 
Fite anked : 

fe xz0 

Packet ciee iscnd : 

Hea ectinn states 

™ om oom mismeteer : 


Toes! (ranetee Gree 





Figure 43. _Paused state of the user interface after a connection loss (laptop) 


Dovwnloucl | Cancel Download 





PFTP PocketPC FS] - @é 11:21 


Figure 44. Paused state of the user interface after a connection loss (Pocket PC) 
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Bytes 68193 to 6448 received 

Bytes 8449 to 8704 received 

Problem reading I/0 Streams 

Transfer cancelled! 

Trying to connect to the server....169.254.1.190 
Transfer cancelled! 

Trying to connect to the server....169.254.1.190 
Transfer cancelled! 

Trying to connect to the server....169.254.1.190 
Transfer cancelled! 

Trying to connect to the server....169.254.1.190 
Transfer cancelled! 

Trying to connect to the server....169.254.1.190 
Transfer cancelled! 

Trying to connect to the server....169.254.1.190 
Client connected! 

File size to receive 11719 bytes 

Bytes 8705 to 8960 received 

Bytes 8961 to 9216 received 





Figure 45. The system output that shows the reconnection procedure 


men med x) 


CONTROL PANEL 


File te cetreive 


Server to coceive hone: 


Add Server 


QChuese seivel mede 


File subeciod : 
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Figure 46. The user interface when the file is transfer is completed in the laptop version 
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100% of map2.GIF received! 


** Message ** 


File transfered in 20588 msec! 


wrilbarl 





Figure 47. The user interface when the file transfer is completed in the Pocket PC version 


e CPS-4. The difference between this scenario and that of CPS-3 is that the 
server mode is auto mode. When the connection is lost, the client 
randomly picks a server randomly from the valid server list and tries to 
that server. Figure 48 shows the system output of the client trying to 
connect to the valid servers. Hopefully, it finds a server to continue the 
partial file transfer. 


a 


Figure 48. 





Bytes 257 to 320 received 

Bytes 321 to 384 received 

Bytes 365 to 448 received 

Problem reading I/0 Streams 

Connection failed! 

auto select next server....151.120.49.173 

Trying to connect to the server....151.120.49.173 
Connection failed! 

auto select next server....131.120.49.171 

Trying to comnect to the server....131.120.49.171 
Connection failed! 

auto select next server....1351.120.49.173 

Trying to connect to the server....1351.120.49.173 
Connection failed! 

auto select next server....131.120.49.174 

Trying to connect to the server....131.120.49.174 
Connection failed! 

auto select next server....1351.120.49.171 

Trying to connect to the server....131.120.49.171 
Connection failed! 

auto select next server....1351.120.49.174 

Trying to connect to the server....131.120.49.174 
Connection failed! 

auto select next server....131.120.49.171 

Trying to connect to the server....1351.120.49.171 
Connection failed! 

auto select next server....127.0.0.1 

Trying to connect to the server....127.0.0.1 
Client connected! 

File size to receive 13310 bytes 

Bytes 449 to 512 received 

Rvtes S13 ton STA received 


Auto server search after a connection loss in auto server mode 


CPS-5. This last scenario tested the response of the client when, after a 
connection loss, it finds a server that has a file with the same name but a 
different file hash value. In that case, the server sent a response that 
informed the client that the file version in its database is not the requested 
one. 
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VI. CONCLUSIONS AND FUTURE WORK 


A. SUMMARY 

The potential goal of this thesis research was to model an _ upper-layer 
communication protocol that can preserve file transfer sessions in a highly mobile 
environment, and implement an application that use and demonstrates the operation of 
this protocol. As a background research, all the well-known file transfer protocols were 
examined in aspect of their communication protocol characteristics and if there is any 


feature that can be used to achieve a partial file transfer after a connection failure. 


The communication protocol that was designed is a client-server-type protocol 
that supports client multithreading in server-side and can dynamically recover from a file 
transfer failure. This partial file recovery feature is achieved by designing and implement 
the client-side program to keep attempting several times asking the server for the part of 


the file was not received when a connection failure occurs. 


Also, the PFTP application was developed to use this protocol and make user able 
to interact with protocol and the file transfer features. User interface was designed so that 
the dynamic partial file retrieval and the can be visible to the use at real time. In order to 
make this function possible, special panels created on the user interface that show the file 


transfer progress and displays the partial file data received 


The communication protocol and the PFTP application tested against several 
scenarios. The main situation that the protocol behavior was tested was when during the 
file transfer the connection failed that caused the client program retry successfully 
reconnecting when in a reasonable time the connection was restored. PFTP application 
also tested in the file management on the server and the multithreaded behavior. The 
client side in both laptop and Pocket PC versions tested successfully in visualizing the 
file transfer progress and in controlling the file transfer options (file request, canceling 


the downloading, or choosing to continue previous failed file transfers). 
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B. FURTHER WORK 
Extending the research scope of this thesis and the application developed in 


support of it, there are issues that raise opportunities for further research. These include: 


j Communication Protocol Design 

Using as a model the PFTP client-server communication protocol, more research 
could be focused on enhancing specific aspect of the protocol it self and how its 
operation can be improved. Some key areas towards this direction could be: 


e Multiple types of session content. Further enhancement in the protocol can 
be done, so various types of sessions (e.g. steaming media, interactive 
connection, etc.) can be supported instead of just file transfers. 


e Use of UDP protocol. The PFTP communication model uses TCP as the 
underlying protocol in the data transfer connection. It would be useful 
implementing the same application using the UDP protocol, and 
comparing the performance of the two implementations with respect to 
data session survivability in a wireless environment. 


e PFTP server locator. Additional feature of the application develop a 
content/server location protocol that will automatic discover server to re- 
establish sessions instead of current manual insertion of servers. 


2. Application Development 


In application development the following further work can be done: 


e Extension the API class library. Create a class or library API for the 
persistent connection protocol that application developers can use to 
develop new applications. 


e Use persistent data sessions. Examine applying the persistent data sessions 
in other type of application where can be useful. 
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APPENDIX. CLASS SOURCE CODE 


//packages for network components 
import java.io.*; 
import java.net.*; 


//packages for user interface components 
import java.awt.*; 

import java.awt.event.*; 

import java.util.*; 

import javax.swing.*; 

import javax.swing.text.*; 

import javax.swing.Swing Utilities; 


//package for security components 
import java.security.*; 


//package for character encoding components 
import sun.misc.*; 


[** 
* File PFTPClient.java 
* 


* This is a FTP Client of the application 

ES 

* This client ask for a file and stays in a loop keep asking 
* until it gets it all. In the first request it receives the 

* hash value of the requested file so when the connection is 
* lost client can ask an other server the same file with out 
* worrying about the authenticity of it. 

* 

* @author LT Periklis Pantoleon 

* @version 1.0 

=] 

class PFTPClient extends JFrame { 


// 


// 


/** The default port where the FTP client is asking the server */ 
private static final int FTP_PORT = 6789; 


a 


/** The string array with the valid servers can be chosen */ 
private static final String[] VALID_SERVERS = { 
"131.120.105.237", "131.120.105.250", "131.120.201.46", "127.0.0.1"}; 


/** The packet size array with the packet sizes can be chosen */ 
private String[] PACKET_SIZES = {new String( "32" ), 

new String("64" ), new String(."128" ), 

new String('"256" ), new String( "512" ), 

new String( "1024" )}; 


/** The connected status */ 
private static final String CONNECTED = "Connected"; 


/** The disconnected status */ 
private static final String DISCONNECTED = "Disconnected"; 


/** The status when the client is trying to connect */ 
private static final String TRYING_TO_CONNECT = "Trying to connect....."; 


/** The timeout period of the TCP sockets */ 
private static final int SO_TIME_OUT = 3000; 


/** The length in bytes of the file hash value */ 
private static final int MD5_HASH_LENGTH = 16; 


/** The font size for the panels’ titles */ 
private static final int PANEL_TITLE_FONT_SIZE = 17; 


/** The font size for the panels’ labels */ 
private static final int PANEL_LABEL_FONT_SIZE = 13; 


/** The panels' font color */ 
private static final Color FONT_COLOR = Color.white; 


/** The color of the background of the frames and panels */ 
private static final Color BACKGROUND_COLOR = new Color( 77, 92, 240 ); 


/** The color of the panels’ border */ 
private static final Color PANEL_BORDER_COLOR = Color.blue; 


/** The maximum reconnection tries each time client lose connection*/ 
private static final int MAX_RECONNECTION_TRIES = 3; 


/** The maximum reconnection tries each time client lose connection */ 
private static final int MAX_TOTAL_TRIES = 3; 
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/** The times that the image is updated in the image progress panel */ 
private static final int IMAGE_UPDATE_TIMES = 10; 


/** The request type when a file is asked */ 
private static final int FILE_REQUEST_TYPE = 1; 


/** The request type when a file array is asked */ 
private static final int FILE_LARRAY_REQUEST_TYPE = 0; 


/** The file name of the logo image of the client frame */ 
private static final String LOGO_IMAGE = "pftpLogoClient. gif"; 
// 


// 


/** The socket client use to communicate with the server */ 
private Socket clientSocket; 


/** The object input stream to receive objects from client */ 
private ObjectInputStream inObjectFromServer; 


/** The object output stream to send objects to client */ 
private ObjectOutputStream outObjectToServer; 


/** The file request received from client */ 
private PFTPFileRequest fileRequest; 


/** The map that store that old partial file bytes */ 
private HashMap oldPartialTransferRequests; 


/** The map that store that old partial file bytes */ 
private HashMap oldPartialTransfersBytes; 


/** The array of the file names that failed to downloaded */ 
private ArrayList oldPartialTransfersFiles; 


/* The array list of the files available on PFTP server */ 
private ArrayList serverAvailableFiles; 


/** The name of the asked file */ 
private String fileNameToAsk; 


/** The server mode selected */ 


59 


private String serverMode; 


/** The server selected */ 
private String serverSelected; 


/** The hash value of the file asked */ 
private String fileHash; 


/** The size in bytes of the file asked */ 
private int fileSize; 


/** The offset from where we need the file */ 
private int offset; 


/** The packet size used for the file transfer */ 
private int packetSize; 


/** The file as a byte array */ 
private byte[] fileInBytes; 


/** The packet counter */ 
private int packetCounter; 


/** The number of packets used for the file*/ 
private int numOfPackets; 


/** The start time of the file reception */ 
private long startTime; 


/** The end time of the file reception */ 
private long stopTime; 


/** The total file transfer time */ 
private long totalFileTransferTime; 


/** The connection status */ 
private String connectionStatus; 


/** The connection loss times */ 
private int connectionLossTimes; 


/** The boolean value of the intetion of the user to ask a file */ 
private boolean wantFile; 


/** The boolean value if the file is transfered or not */ 
private boolean fileTransfered; 
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/** The boolean value the file transfer is canceled or not */ 
private boolean cancelFileTransfer; 


/** The boolean value if a file selected or not */ 
private boolean retrieveFailedTransfers; 


/** The boolean value of the intention of the user to ask a file */ 


private String partialRetreivedFileName; 


// 


/** The container of the main frame */ 
private Container container; 


/** The layout manager of the container */ 
private GridBagLayout layout; 


/** The GridBagConstraints variable of the layout manager*/ 
private GridBagConstraints constraints; 


/** The control panel */ 
private ControlPanel controlPanel; 


/** The panel that shows the transfer progress */ 
private TransferProgressPanel transferProgressPanel; 


/** The panel that shows the transfer status during downloading */ 
private TransferStatusPanel transferStatusPanel; 


/** The panel that displays the image during the downloading */ 
private ImageProgressPanel imageProgressPanel; 


/** The boolean tranfering status */ 
private boolean fileIsTransfering; 


/** The boolean value if user want to download the file or not */ 
private boolean askTheFile; 
// 


// Constructor: 
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[** 
* Default constructor 
*/ 
public PFTPClient() { 


super(""PFTP Laptop 1.0" ); 


// get content pane 
container = getContentPane(); 


// instantiate gridbag constraints 
constraints = new GridBagConstraints(); 


// create the panels 
transferProgressPanel = new TransferProgressPanel( this ); 
transferStatusPanel = new TransferStatusPanel( this ); 
imageProgressPanel = new ImageProgressPanel( this ); 
controlPanel = new ControlPanel( this, transferProgressPanel, 
transferStatusPanel, 
imageProgressPanel ); 


// set the layout of the container 
layout = new GridBagLayout(); 
container.setLayout( layout ); 


// add the panels on the main frame's panels 
//constraints.weightx = 1; 
//constraints.weighty = 1; 

constraints. fill = GridBagConstraints. BOTH; 
addPanel( controlPanel, 0, 0, 1, 4 ); 


//constraints.weightx = 1; 
//constraints.weighty = 1; 
constraints. fill = GridBagConstraints. BOTH; 
addPanel( transferProgressPanel, 4, 0, 1, 1 ); 


//constraints.weightx = 1; 
//constraints.weighty = 1; 

constraints. fill = GridBagConstraints. BOTH; 
addPanel( transferStatusPanel, 5, 0, 1, 3 ); 


constraints.weightx = 1; 
constraints.weighty = 1; 
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constraints. fill = GridBagConstraints. BOTH; 
addPanel( new JScrollPane( imageProgressPanel ), 0, 1, 1, 8 ); 


//sets other attributes of the main frame 

setSize( 700, 500 ); 

setLocation( 50, 100 ); 

setVisible( true ); 

setExtendedState( JFrame.MAXIMIZED_BOTH ); 
setResizable( true ); 


setDefaultCloseOperation( JFrame.EXIT_ON_CLOSE ); 


/Anitialization of the private members 
oldPartialTransferRequests = new HashMap(); 
oldPartialTransfersBytes = new HashMap(); 
oldPartialTransfersFiles = new ArrayList(); 
serverAvailableFiles = new ArrayList(); 


fileInBytes = null; 
fileNameToAsk = null; 
fileSize = 0; 

packetSize = 0; 

fileHash = ""; 
connectionStatus = DISCONNECTED; 
connectionLossTimes = 0; 
totalFileTransferTime = 0; 
retrieveFailedTransfers = false; 
filelsTransfering = false; 
askTheFile = false; 


} // end default constructor 


[** 
* Add a component using the GridBagLayout 
* 
* @param component the component to add 
* @paramrow _ the row to add the component 
* @param column __ the column to add the component 
* @param width _ the width in columns of the component 
* @param height _ the heigth in rows of the component 
a 
private void addPanel( Component component, 
int row, int column, int width, int height ){ 
constraints. gridx = column; 
constraints.gridy = row; 
constraints.gridwidth = width; 
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constraints. gridheight = height; 
// set constraints and add component 
layout.setConstraints( component, constraints ); 
container.add( component ); 

} /fend addPanel() method 


[** 


* Adds a panel to a container 
* 


* @param container the container to add the panel 

*/ 

public void addPanel( Container container ){ 
JPanel dummy = new JPanel(); 
dummy.setBackground( BACKGROUND_COLOR ); 
container.add( dummy ); 

} /fend addPanel() method 


[** 


* Opens the streams for communicating with the client 
* 


* @throws IOException when the outpu/input stream can not be openned 
7 
private void openStreams() throws IOException { 


// open the sreams needed 
inObjectFromServer = new ObjectInputStream( clientSocket.getInputStream() ); 
outObjectToServer = new ObjectOutputStream( clientSocket.getOutputStream() ); 


} // end openStreams() method 


[** 


* Selects one from the valid server to try connecting 
ok 


* @return a string IP address of the server 
| 
private String selectServer() { 


String serverToReturn; 

double random = 10 * Math.random(); 
int randomIndex = ( int ) random; 
serverToReturn = VALID_SERVERS[randomIndex % VALID_SERVERS length]; 
return serverToReturn; 


} // end selectServer() method 


[** 
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* Selects one from the valid server to try connecting 

* 

* @return a string IP address of the server 

* @throws IOException if the input/output streams fail 
* @throws ClassNotFoundException if the received object is not of a known class 

aT 

private ArrayList getServerAvailableFiles() throws IOException, 
ClassNotFoundException { 


boolean exit = false; 
boolean connected = false; 
int serverIndex = 0; 


if( serverMode == "Auto select" ){ 
while( !connected && ( serverIndex < VALID_SERVERS.length ) ){ 
serverSelected = VALID_SERVERS|[serverIndex]; 
System.out.printIn( "server : " + serverSelected ); 
serverIndex++; 
try{ 
clientSocket = new Socket( serverSelected, FTP_PORT ); 
connected = true; 
} catch( IOException ioe ){ 
} //end try catch block 
} //end while 
if( !connected ){ 
clientSocket = new Socket( serverSelected, FTP_PORT ); 


} 
} else { 
clientSocket = new Socket( serverMode, FTP_PORT ); 


} 


openStreams(); 
connectionStatus = CONNECTED; 
transferStatusPanel.updateFileTransferStatus(); 
fileRequest = new PFTPFileRequest( FILE_ARRAY_REQUEST_TYPE, 
new String(), 
new String(), 
0, 
0); 


//send the file request object to the server 
outObjectToServer.writeObject( fileRequest ); 
outObjectToServer.flush(); 

Vector filesAtServer = ( Vector ) inObjectFromServer.readObject(); 
serverAvailableFiles = new ArrayList(); 

for( int i = 0; 1 < filesAtServer.size(); i++ ){ 
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serverAvailableFiles.add( filesAtServer.elementAt( i ) ); 
} 
System.out.printIn( "Files at server : " + serverAvailableFiles ); 
clientSocket.closeQ; 


connectionStatus = DISCONNECTED; 
transferStatusPanel.updateFileTransferStatus(); 


return serverA vailableFiles; 


} // end selectServer() method 


[** 
* Sends a file request package to the server asking for a file 
* 
* @param fileRequest the file request 
* @throws Exception 
if 
public void askForFile( PFTPFileRequest fileRequest ) throws Exception { 


// some variable initialization 
boolean fileNotFound = false; 
fileTransfered = false; 
cancelFileTransfer = false; 
packetCounter = 0; 

int byteCounter = 0; 

int numOfBytes = 1; 

int percent = 0; 
numOfPackets = 1; 
fileNameToAsk = fileRequest.getFileQ; 
boolean firstIteration = true; 


// create a file to receive 
File file = new File( fileNameToAsk ); 


int connectionCounter = 1; 
int imagePacketUpdate = 0; 
int imagePacketUpdateCounter = 1; 


//update the file status panel 
transferStatusPanel.updateFileTransferStatus(); 


if( retrieveFailedTransfers ){ 
offset = fileRequest.getOffsetQ); 
fileHash = fileRequest.getHash(); 
packetCounter = offset; 
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numOfPackets = packetCounter + 1; 
} /end if 


// The loop that keep asking the file till gets it all 
while( !cancelFileTransfer && !fileTransfered && !fileNotFound && 
( packetCounter < numOfPackets ) && 
( connectionCounter <= ( MAX RECONNECTION_TRIES * 


MAX_TOTAL_TRIES ) ) ){ 


if( ( ( MAX _RECONNECTION_TRIES * MAX _TOTAL_TRIES ) % 
connectionCounter ) == 
1 ){ 

delay( 2000 ); 
} else{ 

delay( 2000 ); 
} /fend if else 
connectionCounter++; 


try 
if( serverMode.equals( new String( "Auto select" ) ) ){ 


//select a valid server to try connect 
if( !firstIteration ){ 


serverSelected = selectServer(); 


} 
} else{ 


serverSelected = serverMode; 
} //end if 
System.out.printIn( "Trying to connect to the server..." + 

serverSelected ); 

delay( 2000 ); 
//connect to the server selected and set the time out period 
clientSocket = new Socket( serverSelected, FTP_PORT ); 
clientSocket.setSoTimeout( SO_TIME_OUT ); 


connectionStatus = CONNECTED; 
transferStatusPanel.updateFileTransferStatus(); 


System.out.printIn( "Client connected!" ); 


try 
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openStreams(); 
} catch( Exception ioe ){ 


JOptionPane.showMessageDialog( null, "Client: Failed to open streams", 
"Exception", 
JOptionPane.ERROR_MESSAGE, null ); 
} // end try catch block 


fileRequest.setOffset( offset ); 
fileRequest.setHash( fileHash ); 


//send the file request object to the server 
outObjectToServer.writeObject( fileRequest ); 
outObjectToServer.flushQ); 


//receive the file hash value if it is asked for the first time 
fileHash = inObjectFromServer.readUTF(Q); 
System.out.printIn( "Hash value received " + fileHash ); 


if( !fileHash.equals( new String( "fileNotFound" ) ) && 
!fileHash.equals( new String( "hashProblem" ) ) && 
!fileHash.equals( new String( "fileNotMatch" ) ) ){ 


//receive the file size from the server 

fileSize = inObjectFromServer.readInt(); 

System.out.printIn( "File size to receive " + fileSize + " bytes" ); 
numOfPackets = ( fileSize / packetSize ) + 1; 

imagePacketUpdate = numOfPackets / ( IMAGE_UPDATE_TIMES - 1 ); 


//fupdate the transfer status panel 
transferStatusPanel.updateFileTransferStatus(); 


if( packetCounter == 0 ){ 


/Anitialize a byte array for the file bytes 
fileInBytes = new byte[fileSize + packetSize]; 


} else if( retrieveFailedTransfers && firstIteration ){ 
firstIteration = false; 
byte[] partialBytes = ( byte[] ) oldPartialTransfersBytes. get( 
fileNameToAsk ); 
ByteArrayOutputStream baos = 
new ByteArrayOutputStream( fileSize + packetSize ); 
baos.write( partialBytes, 0, partialBytes.length ); 
fileInBytes = baos.toByteArray(); 
baos.close(); 
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byteCounter = packetSize * offset; 
} /fend if else if 


byte[] newPacket = new byte[packetSize]; 


try { 
if( packetCounter == 0 ){ 
startTime = System.currentTimeMillis(); 
} end if 


filelsTransfering = true; 


//sets the maximum of the transfer progress bar 
transferProgressPanel.setProgressBarMax( numOfPackets ); 


try{ 
//receiving the packets and updating the file byte array 
while( !cancelFileTransfer && ( packetCounter < numOfPackets ) ){ //end if 
offset = packetCounter; 
inObjectFromServer.read( newPacket ); 


transferProgressPanel.updateProgressBar( packetCounter ); 


for( int i = 0; i < packetSize; i++ ){ 
fileInBytes[byteCounter + i] = newPacket[i]; 
} //end for loop 
System.out.printIn( "Bytes " + ( byteCounter + 1 ) + 
"to " + ( byteCounter + packetSize ) + 
"received" ); 
if( ( packetCounter % imagePacketUpdate ) == 0 ){ 
/fapdate image progress panel 
imageProgressPanel.updateImageProgress( fileInBytes ); 
} /and if 
totalFileTransferTime = System.currentTimeMillis() - startTime; 
delay( 500 ); 
byteCounter += packetSize; 
packetCounter++; 
} //end while loop 
} catch( NullPointerException npe ){ 
System.out.printIn( "Problem with null pointers" ); 


} 


//renews the maximum of the transfer progress bar 
transferProgressPanel.setProgressBarMax( numOfPackets - | ); 


} catch( IOException ioe ){ //in case of connection loss 
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System.out.printIn( "Problem reading I/O Streams" ); 
connectionStatus = DISCONNECTED; 
connectionLossTimes++; 
transferStatusPanel.updateFileTransferStatus(); 

} //end try catch block 


stopTime = System.currentTimeMillis(); 


//create the file and pass the byte array formed in it 
if( !cancelFileTransfer && packetCounter == numOfPackets ) { 
fileTransfered = true; 
outObjectToServer.writeBoolean( true ); 
outObjectToServer.flushQ); 
if( !file.createNewFile() ){ 
file.deleteQ); 
} end if 
file = new File( fileNameToAsk ); 
file.createNewFileQ; 
FileOutputStream editFile = new FileOutputStream( file ); 
editFile.write( fileInBytes ); 


totalFileTransferTime = stopTime - startTime; 


editFile.close(); 
if( retrieveFailedTransfers ){ 
deletePartialFileRequest( fileNameToAsk ); 
retrieveFailedTransfers = false; 
deletePartialFileRequest( fileNameToAsk ); 
} /end if 
transferProgressPanel.updateProgressBar( packetCounter - 1 ); 
transferStatusPanel.updateFileTransferStatus(); 
imageProgressPanel.updateImageProgress( fileInBytes ); 
imageProgressPanel.updateImageProgress( fileInBytes ); 


JOptionPane.showMessageDialog( null, 
"File successfully transfered in\n" + 
" "W + 
totalFileTransferTime + " msec", null, 
JOptionPane. INFORMATION_MESSAGE, null ); 
resetApplication(); 


} else{ 
outObjectToServer.writeBoolean( false ); 
outObjectToServer.flushQ); 
System.out.printIn( "File: " + fileNameToAsk + 
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" transfer interrupted!" ); 
} /end if else 
} else if( fileHash.equals( new String( "fileNotMatch" ) ) ){ 
System.out.printIn( "Server doesn't have the file version asked!" ); 
} /end if else 


try{ 
System.out.printIn( "Close socket" ); 
clientSocket.closeQ); 

} catch( IOException ioe ){ 


} //end try catch block 
} catch( Exception ce ){ 
connectionStatus = TRYING_TO_CONNECT; 
transferStatusPanel.updateFileTransferStatus(); 
if( connectionCounter == ( MAX_RECONNECTION_TRIES 
MAX_TOTAL_TRIES + 1 ) ){ 
JOptionPane.showMessageDialog( null, 
"The server couldn't be reached ", null, 
JOptionPane.ERROR_MESSAGE, null ); 
} //end if 
} //end try catch block 


if( connectionStatus == TRYING_TO_CONNECT ){ 
System.out.printIn( "Connection failed!" ); 
} end if 
firstIteration = false; 
} //end while loop 


if( !fileTransfered && !cancelFileTransfer ) { 
fileRequest.setOffset( offset ); 
System.out.printIn( "fileHash saved" + fileHash ); 
fileRequest.setHash( fileHash ); 
savePartialFileRequest( fileRequest, 
fileInBytes ); 


JOptionPane.showMessageDialog( null, " File transfer failed!\n " + 
"The partial file data stored for future use", null, 
JOptionPane. INFORMATION_MESSAGE, null ); 
resetApplication(); 
} /end if 


} //fend askForFile() method 


[** 


* Cancels the file's transfer 
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*/ 

public void cancelFileTransfer() { 
cancelFileTransfer = true; 

} end setFileNameToAsk() method 


[** 
* Sets the file name to ask the server 
ok 
* @param fileName the string file name 
id 
public void setFileNameToAsk( String fileName ){ 
fileNameToAsk = fileName; 
} fend setFileNameToAsk() method 


[** 
* Starts the file dowmnloading 
k 
* @param ask true if the ask the file button is pressed 
| 
public void setAskTheFile( boolean ask ){ 
askTheFile = ask; 
} fend setFileNameToAsk() method 


[** 

* Sets the server mode of the file transfer 
ES 

* @param mode the string server mode 

a A 

public void setServerMode( String mode ){ 
serverMode = mode; 

} /fend setServerMode() method 


[** 


* Sets the packet size for the file transfer 
k 
* @param sizeOfThePacket the packet size selected for the file transfer 
zt 
public void setPacketSize( int sizeOfThePacket ){ 
packetSize = sizeOfThePacket; 
} //fend setPacketSize() method 


[** 


* Sets the offset for the file transfer 
ok 


* @param theOffset the offset value 
a 


72 


public void setOffset( int theOffset ) { 
offset = theOffset; 
} //fend setPacketSize() method 


[** 
* Returns the name of the file asked from the server 
ES 
* @return the name of the file asked from the server 
me 
public synchronized String getServerSelected() { 
notifyQ; 
return serverSelected; 
} //end getFileNameToAsk() method 


[** 

* Returns the name of the file asked from the server 
ES 

* @return the name of the file asked from the server 
| 

public synchronized String getFileNameToAsk() { 
notifyQ; 
return fileNameToAsk; 

} //end getFileNameToAsk() method 


[** 

* Returns the size of the file asked from the server 
* 

* @return the size of the file asked from the server 
+} 

public synchronized int getPacketSize() { 
notify(); 
return packetSize; 

} //end getPacketSize() method 


[** 


* Returns the size in bytes of the file asked 
* 


* @return the size ij bytes of the file asked 
a 
public synchronized int getFileSize(){ 
notifyQ; 
return fileSize; 
} //end getFileSize() method 


[** 


* Returns the number of packet needed for the transfer 
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*k 


* @return the number of packets need for the transfer 
| 
public synchronized int getNumOfPackets() { 
notify; 
return numOfPackets; 
} //end getNumOfPackets() method 


[** 
* Returns the number of packet already received 
ES 


* @return the number of packet already received 
*] 

public synchronized int getReceivedPackets() { 
notify(); 
return packetCounter; 

} //end getReceivedPackets() method 


[** 
* Returns the file bytes as byte array 
* 


* @return the file bytes as byte array 

=] 

public synchronized byte[] getFileInBytes(){ 
notify(); 

return fileInBytes; 

} //end getFileInBytes() method 


[** 
* Returns the connection status 
BS 


* @return the connection status 

aid 

public synchronized String getConnectionStatus() { 
notifyQ; 

return connectionStatus; 

} //end getConnectionStatus() method 


[** 


* Returns the connection loss times 
BS 


* @return the connection loss times 
*/ 
public synchronized int getConnectionLossTimes() { 
notifyQ; 
return connectionLossTimes; 
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} //end getConnectionLossTimes() method 


[** 
* Returns the total file transfer time 
* 
* @return the total file transfer time 
a 
public synchronized long getTotalFileTransferTime() { 
notify(); 
return totalFileTransferTime; 
} //end getTotalFileTransferTime() method 


[** 

* Returns the total file transfer time 

ok 

* @return the total file transfer time 

*/ 
public synchronized boolean getFileTransfered() { 

notify(); 

return fileTransfered; 

} //end getTotalFileTransferTime() method 


[** 
* Returns the total file transfer time 
ok 
* @return the total file transfer time 
e/ 
public synchronized ControlPanel getControlPanel() { 
notifyQ; 
return controlPanel; 
} //end getTotalFileTransferTime() method 


[** 
* Return a titled JtextPanel with specific attributes 
* 
* @param titleText the delay time in milliseconds 
* @param charSize the character size 
* @param charColor the character color 
* @param backgroundColor the backgroundColor 
* @param isUnderlined if the character is underlined or not 
* @param isBold if the character is bold or not 
* @return a titled JtextPanel with specific attributes 
*/ 
public JTextPane getTitledPanel( String titleText, int charSize, 
Color charColor, Color backgroundColor, 
boolean isUnderlined, boolean isBold ){ 
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JTextPane textPane; 
DefaultStyledDocument doc = new DefaultStyledDocument(); 
textPane = new JTextPane( doc ); 
MutableAttributeSet attr = new SimpleAttributeSetQ); 
//StyleConstants.setBackground(attr, Color.blue); 
StyleConstants.setFontSize( attr, charSize ); 
StyleConstants.setUnderline( attr, isUnderlined ); 
StyleConstants.setForeground( attr, charColor ); 
StyleConstants.setBold( attr, isBold ); 
textPane.setAlignmentX( JTextPane. CENTER_ALIGNMENT ); 
textPane.setAlignmentY( JTextPane. CENTER_ALIGNMENT ); 
textPane.setEditable( false ); 
textPane.setEnabled( false ); 
textPane.setBackground( BACKGROUND_COLOR ); 
textPane.setCharacterAttributes( attr, true ); 
textPane.setText( titleText ); 
return textPane; 

} //end getTitledPanel() method 


[** 
* Returns the boolean value of file transfering status 
ES 
* @return true if file is still transferring, false otherwise 
7 
public boolean getFileIsTransfering() { 
return fileIsTransfering; 


} 


[** 
* Saves a partial file request to file request database for future use 
* 
* @param partialFileRequest the partial file request to save in database 
* @param partialFileBytes the partial file bytes to save in database 
ef 
public void savePartialFileRequest( PFTPFileRequest partialFileRequest, 
byte[] partialFileBytes ){ 


oldPartialTransferRequests.put( partialFileRequest.getFile(), 
partialFileRequest ); 
oldPartialTransfersBytes.put( partialFileRequest.getFile(), 
partialFileBytes ); 
oldPartialTransfersFiles.add( partialFileRequest.getFile() ); 


} //end savePartialFileRequest() method 


[** 
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* Deletes a partial file request from file request database 
* 


* @param partialFileNameRequested the name of the file of the 
7 request to delete from database 
| 
public void deletePartialFileRequest( String partialFileNameRequested ){ 


oldPartialTransferRequests.remove( partialFileNameRequested ); 
oldPartialTransfersB ytes.remove( partialFileNameRequested ); 
oldPartialTransfersFiles.remove( partialFileNameRequested ); 


} //end deletePartialFileRequest() method 


[** 
* Resets the client application 
*/ 

public void resetApplication() { 


fileSize = 0; 

fileHash = ""; 

connectionStatus = DISCONNECTED; 
connectionLossTimes = 0; 
totalFileTransferTime = 0; 


controlPanel.reset(); 
transferProgressPanel.reset(); 
transferStatusPanel.reset(); 
imageProgressPanel.reset(); 


} //end resetApplication() method 


[** 
* Stops the panel threads of the downloading panels 
| 
public void startCheckToAsk(){ 
while( true ){ 
delay( 50 ); 
if( askTheFile ){ 
try{ 
askForFile( fileRequest ); 
} catch( Exception e ){ 


} 


re 


askTheFile = false; 
} 


} 
} end 


[** 


* Delay the execution of the code 
* 


* @param msec the delay time in milliseconds 
| 
public void delay( int msec ){ 

try{ 


Thread.sleep( msec ); 
} catch( InterruptedException ie ){ 


} 
} //end delay() method 


[** 


* The main method 
ok 


* @param args the arguments 

* @throws Exception if exception occurs in FTPClient application 
7 

public static void main( String args[] ) throws Exception { 


PFTPClient client = new PFTPClient(); 
client.startCheckToAsk(); 


} //end main method 


// 


[** 


* Provide a control panel to control the application 
si 
private class ControlPanel extends JPanel { 


/** The PFTPClient class object */ 
private PFTPClient controlPanelClient; 


/** The panel that shows the transfer progress */ 
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private TransferProgressPanel progressPanel; 


/** The panel that shows the transfer status during downloading */ 
private TransferStatusPanel statusPanel; 


/** The panel that displays the image during the downloading */ 
private ImageProgressPanel imagePanel; 


/** The title for the control panel */ 
private JPanel controlPanelTitle; 


/** The FileSelectionDialog object for file choice */ 
private FileSelectionDialog fileChoiceDialog; 


/** The text field for file choice */ 
private JTextField fileChoiceField; 


/** The combo box for server mode choice */ 
private JComboBox serverModeChoiceBox; 


/** The combo box for packet size choice */ 
private JComboBox packetSizeChoiceBox; 


/** The button group for file choice */ 
private ButtonGroup fileButtonGroup; 


/** The button group for server choice */ 
private ButtonGroup serverButtonGroup; 


[** 

* The radio button that give the option to retrieve 
* previous partial transferred files 

| 
private JRadioButton previousFailedFiles; 


[** 
* The radio button that give the option to retrieve 
* files from a PFTP server 
*/ 

private JRadioButton filesFromServer; 


[** 
* The radio button that give the option to the user 
* to enter the server IP manually 
= 

private JRadioButton manualServerSelection; 
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[** 
* The radio button that give the option to the user 
* to from the predefined PFTP servers 
20 

private JRadioButton predefinedServerSelection; 


/** The button to a server manual */ 
private JButton selectServer; 


/** The button to retreive the availiable file at PFTP Server */ 
private JButton retreiveAvailableFiles; 


/** The button to ask for the file transfer */ 
private JButton askTheFile; 


/** The button to cancel the file transfer */ 
private JButton cancelTransfer; 


/** The text field to enter manual the server to ask the file from */ 
private JTextField manualSelectServer; 


/** The server IP array with servers can be chosen */ 
private String[] serverIPs; 


/** The packet size array with the packet sizes can be chosen */ 
private String[] packetSizes; 


/** The file selected */ 
private String fileSelection; 


/** The server selected */ 
private String serverSelection; 


/** The packet size selected */ 
private String packetSizeSelection; 


/** The boolean value if a file selected or not */ 
private boolean fileSelected = false; 


/** The boolean value if a server selected or not */ 
private boolean serverSelected = false; 


/** The boolean value if a packet size selected or not */ 
private boolean packetSizeSelected = false; 
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[** 
* The default constructor 
* 
* @param panelClient the FTPClientVer7 object assosiated with 
* @param progressPanel the TransferProgressPanel object assosiated with 
* @param statusPanel the TransferStatusPanel object assosiated with 
* @param imagePanel the ImageProgressPanel object assosiated with 
*/ 
public ControlPanel( PFTPClient panelClient, 
TransferProgressPanel progressPanel, 
TransferStatusPanel statusPanel, 
ImageProgressPanel imagePanel ){ 


super(); 


serverIPs = new String] VALID_SERVERS length + 2]; 
for( int 1 = 0; i < serverIPs.length; i++ ){ 
if(i==0 ){ 
serverIPs[i] = "Select server"; 
} else if( i == 1 ){ 
serverIPs[i] = "Auto select"; 
} else { 
serverIPs[i] = VALID_SERVERS|i - 2]; 
} /end if else if 
} //end for loop 


packetSizes = new String[PACKET_SIZES.length + 1]; 
for( int i = 0; i < packetSizes.length; i++ ){ 
if(i==0 ){ 
packetSizes[i] = "Select packet size"; 
} else{ 
packetSizes[i] = PACKET_SIZES[i - 1]; 
} /end if else if 
} //end for loop 


controlPanelClient = panelClient; 
progressPanel = progressPanel; 
statusPanel = statusPanel; 
imagePanel = imagePanel; 


setBorder( BorderFactory.createLineBorder( PANEL_BORDER_COLOR ) ); 
setBackground( BACKGROUND_COLOR ); 
setLayout( new GridLayout( 8, 3 ) ); 


add(_—s get TitledPanel( "CONTROL PANEL", PANEL TITLE_FONT_SIZE, 
FONT_COLOR, 
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BACKGROUND_COLOR, true, true ) ); 


// just to fill the empty cells 
controlPanelClient.addPanel( this ); 
controlPanelClient.addPanel( this ); 


// construct textfield with default sizing 

add( getTitledPanel( "File to retreive:", PANEL_LABEL_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ) ); 


fileButtonGroup = new ButtonGroup(); 
previousFailedFiles = new JRadioButton( "Previous failures", false ); 
filesFromServer = new JRadioButton( "PFTP Server files", true ); 


//Ainner class to handle JRadioButton events 
ItemListener fileMode = new ItemListener() { 


// handle JRadioButton event 
public void itemStateChanged( ItemEvent event ){ 
// determine whether check box selected 
if( event.getSource() == previousFailedFiles ){ 
String[] fileList = new String[oldPartialTransfersFiles.size() + 1]; 
for( int i = 0; i < fileList.length; i++ ){ 
if(i==0 ){ 
fileList[i] = "Select file"; 
} else{ 
fileList[1] = ( String ) oldPartialTransfersFiles.get( i - 1 ); 
} //end if else 
} //end for loop 
if( previousFailedFiles.isSelected() && 
!oldPartialTransfersFiles.isEmpty() ){ 
retrieveFailedTransfers = true; 
fileChoiceDialog = new FileSelectionDialog( controlPanelClient, 
controlPanelClient. getControlPanel(), 
fileChoiceField, 
fileList ); 
packetSizeSelected = true; 
} else if( previousFailedFiles.isSelected() && 
oldPartialTransfersFiles.isEmpty() ){ 
JOptionPane.showMessageDialog( null, 
"No file transfer failure by now!\n" + 
"Select a file from the PFTP servers.", 
null, 
JOptionPane. INFORMATION_MESSAGE, 
null ); 
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manualServerSelection.setEnabled( false ); 
predefinedServerSelection.setEnabled( false ); 
manualSelectServer.setEnabled( false ); 
selectServer.setEnabled( false ); 
serverModeChoiceBox.setEnabled( false ); 
retreiveA vailableFiles.setEnabled( false ); 
packetSizeChoiceBox.setEnabled( false ); 
askTheFile.setEnabled( false ); 

} 

} else if( event.getSource() == filesFromServer ){ 
manualServerSelection.setEnabled( true ); 
predefinedServerSelection.setEnabled( true ); 
serverModeChoiceBox.setEnabled( true ); 
askTheFile.setEnabled( true ); 

} /end if else 

} //end itemstateChanged 


}; //end anonymous inner class 


previousFailedFiles.addItemListener( fileMode ); 
previousFailedFiles.setBackground( BACKGROUND_COLOR ); 
previousFailedFiles.setForeground( FONT_COLOR ); 


filesFromServer.addItemListener( fileMode ); 
filesFromServer.setBackground( BACKGROUND_COLOR ); 
filesFromServer.setForeground( FONT_COLOR ); 


fileButtonGroup.add( previousFailedFiles ); 
fileButtonGroup.add( filesFromServer ); 


add( previousFailedFiles ); 
add( filesFromServer ); 


// construct textfield with default sizing 

add( getTitledPanel( "Server to receive from:", PANEL_LABEL_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ) ); 


serverButtonGroup = new ButtonGroup(); 
manualServerSelection = new JRadioButton( "Manual Selection", false ); 


predefinedServerSelection = new JRadioButton( "Existing Servers", true ); 


//inner class to handle JRadioButton events 
ItemListener serverListener = new ItemListener(){ 


// handle JRadioButton event 
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public void itemStateChanged( ItemEvent event ){ 

// determine whether a radio button selected 

if( event.getSource() == manualServerSelection ){ 
manualSelectServer.setEnabled( true ); 
serverModeChoiceBox.setEnabled( false ); 
selectServer.setEnabled( true ); 

} else if( event.getSource() == predefinedServerSelection ){ 
manualSelectServer.setEnabled( false ); 
selectServer.setEnabled( false ); 
serverModeChoiceBox.setEnabled( true ); 

} /end if else 

} //end itemstateChanged 


}; //end anonymous inner class 


manualServerSelection.addItemListener( serverListener ); 
manualServerSelection.setBackground( BACKGROUND_COLOR ); 
manualServerSelection.setForeground( FONT_COLOR ); 


predefinedServerSelection.addItemListener( serverListener ); 
predefinedServerSelection.setBackground( BACKGROUND_COLOR ); 
predefinedServerSelection.setForeground( FONT_COLOR ); 


serverButtonGroup.add( manualServerSelection ); 
serverButtonGroup.add( predefinedServerSelection ); 


add( manualServerSelection ); 
add( predefinedServerSelection ); 


// construct textfield with default sizing 

add( getTitledPanel( "Add Server IP:", PANEL_LABEL_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ) ); 


manualSelectServer = new JTextField( "Enter server IP" ); 
manualSelectServer.setEditable( true ); 
manualSelectServer.setEnabled( false ); 

add( manualSelectServer ); 


// constructs the select server button 

selectServer = new JButton( "Select the server" ); 

selectServer.setFont( new Font( null, Font. BOLD, PANEL LABEL _FONT_SIZE ) ); 
selectServer.setForeground( FONT_COLOR ); 
selectServer.setHorizontalTextPosition( JButton.LEFT ); 
selectServer.setBackground( BACKGROUND_COLOR ); 

selectServer.setEnabled( false ); 
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selectServer.addActionListener( new ActionListener() { 
public void actionPerformed( ActionEvent event ){ 


try{ 


String serverIP = manualSelectServer.getText(); 
InetAddress.getByName( serverIP ); 
if( !retrieveFailedTransfers ){ 
retreiveA vailableFiles.setEnabled( true ); 
} 
packetSizeChoiceBox.setEnabled( false ); 
controlPanelClient.setServerMode( serverIP ); 
serverSelected = true; 
} catch( UnknownHostException uhe ){ 
JOptionPane.showMessageDialog( null, 
"Select a valid server IP address!", 
null, 
JOptionPane. INFORMATION_MESSAGE, 
null ); 
} 


} //end actionPerformed() method 
} //fend ActionListener class 
); end addActionListener() method 


add( selectServer ); 


// construct textfield with default sizing 

add( getTitledPanel( "Choose server mode:", PANEL_LABEL_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ) ); 


// construct textfield with default sizing 
serverModeChoiceBox = new JComboBox( serverIPs ); 
serverModeChoiceBox.setFont( new Font( null, Font.BOLD, 
PANEL_LABEL_FONT_SIZE ) ); 
serverModeChoiceBox.setBackground( BACKGROUND_COLOR ); 
serverModeChoiceBox.setForeground( FONT_COLOR ); 
serverModeChoiceBox.setEnabled( true ); 
serverModeChoiceBox.addItemListener( 


// anonymous inner class to handle JComboBox events 
new ItemListener(){ 


// handle JComboBox event 
public void itemStateChanged( ItemEvent event ){ 
// determine whether check box selected 
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if( event.getStateChange() == ItemEvent.SELECTED ){ 


serverSelection = serverIPs[serverModeChoiceBox.getSelectedIndex()]; 


serverSelected = true; 
if( !retrieveFailedTransfers ){ 
retreiveA vailableFiles.setEnabled( true ); 
} 
} 


controlPanelClient.setServerMode( serverSelection ); 


} 


} // end anonymous inner class 


); // end call to addItemListener 
add( serverModeChoiceBox ); 


// constructs the retreive files button 
retreiveAvailableFiles = new JButton( "Retreive files.. " ); 
retreiveA vailableFiles.setFont( new Font( null, Font.BOLD, 
PANEL_LABEL_FONT_SIZE ) ); 
retreiveA vailableFiles.setForeground( FONT_COLOR ); 
retreiveA vailableFiles.setHorizontalTextPosition( JButton.LEFT ); 
retreiveA vailableFiles.setBackground( BACKGROUND_COLOR ); 
retreiveAvailableFiles.addActionListener( new ActionListener(){ 
public void actionPerformed( ActionEvent event ){ 
try 
serverAvailableFiles = controlPanelClient.getServerA vailableFiles(); 
retreiveA vailableFiles.setEnabled( false ); 
if( !serverAvailableFiles.isEmpty( ){ 
String[] fileList = new String[serverAvailableFiles.sizeQ) + 1]; 
for( int i = 0; 1 < fileList.length; i++ ){ 
if(i==0 ){ 
fileList[i] = "Select file"; 
} else{ 
fileList[i] = ( String ) serverAvailableFiles.get( i - 1 ); 
} /end if else 
} //end for loop 
fileChoiceDialog = new FileSelectionDialog( controlPanelClient, 
controlPanelClient. getControlPanel(), 
fileChoiceField, 
fileList ); 
packetSizeChoiceBox.setEnabled( true ); 
} else { 
JOptionPane.showMessageDialog( null, 
"No files availiable at server", 
null, 
JOptionPane. INFORMATION_MESSAGE, 
null ); 
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)); 


} //end if else 
} catch( IOException ioe ){ 
JOptionPane.showMessageDialog( null, 
"Fail to retreive file names from PFTP server", 
"Exception", 
JOptionPane.ERROR_MESSAGE, null ); 
retreiveA vailableFiles.setEnabled( false ); 


} catch( ClassNotFoundException cnfe ){ 
JOptionPane.showMessageDialog( null, "Unknown object received", 
"Exception", 
JOptionPane.ERROR_MESSAGE, null ); 
retreiveA vailableFiles.setEnabled( false ); 
} //end try catch block 


} //end actionPerformed() method 
} //fend ActionListener class 
); /end addActionListener() method 


retreiveA vailableFiles.setEnabled( false ); 
add( retreiveAvailableFiles ); 


// construct textfield with default sizing 

add( getTitledPanel( "File selected :", PANEL_LABEL_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ) ); 


// construct textfield with default sizing 
fileChoiceField = new JTextField( "No file selected" ); 
fileChoiceField.setFont( new Font( null, Font. BOLD, PANEL LABEL FONT_SIZE 


fileChoiceField.setBackground( BACKGROUND_COLOR ); 
fileChoiceField.setForeground( FONT_COLOR ); 
fileChoiceField.setEditable( false ); 


add( fileChoiceField ); 


// construct packet size choice box 
packetSizeChoiceBox = new JComboBox( packetSizes ); 
packetSizeChoiceBox.setFont( new Font( null, Font. BOLD, 
PANEL_LABEL_FONT_SIZE ) ); 
packetSizeChoiceBox.setBackground( BACKGROUND_COLOR ); 
packetSizeChoiceBox.setForeground( FONT_COLOR ); 
packetSizeChoiceBox.setEnabled( true ); 
packetSizeChoiceBox.addItemListener( 
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// anonymous inner class to handle JComboBox events 
new ItemListener(){ 


// handle JComboBox event 
public void itemStateChanged( ItemEvent event ){ 
// determine whether check box selected 
if( event.getStateChange() == ItemEvent.SELECTED ){ 
packetSizeSelection = packetSizes[packetSizeChoiceBox. 
getSelectedIndex()]; 
System.out.printIn( "packet size selected.. " + packetSizeSelection ); 
controlPanelClient.setPacketSize( new Integer( packetSizeSelection ). 
intValue() ); 
packetSizeSelected = true; 
askTheFile.setEnabled( true ); 


} 
} //end anonymous inner class 
); // end call to addItemListener 


packetSizeChoiceBox.setEnabled( false ); 
add( packetSizeChoiceBox ); 


controlPanelClient.addPanel( this ); 


// constructs the download button 
askTheFile = new JButton( "Download ", 
new Imagelcon( "downloadArrow. gif" ) ); 
askTheFile.setFont( new Font( null, Font. BOLD, PANEL LABEL _FONT_SIZE ) ); 
askTheFile.setForeground( FONT_COLOR ); 
askTheFile.setHorizontalTextPosition( JButton.LEFT ); 
askTheFile.setBackground( BACKGROUND_COLOR ); 
askTheFile.addActionListener( new ActionListener() { 
public void actionPerformed( ActionEvent event ){ 
if( fileSelected && serverSelected && packetSizeSelected ){ 
// change enabled status of panel elements 
filesFromServer.setEnabled( false ); 
previousFailedFiles.setEnabled( false ); 
manualServerSelection.setEnabled( false ); 
predefinedServerSelection.setEnabled( false ); 
manualSelectServer.setEnabled( false ); 
selectServer.setEnabled( false ); 
serverModeChoiceBox.setEnabled( false ); 
retreiveA vailableFiles.setEnabled( false ); 
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packetSizeChoiceBox.setEnabled( false ); 
askTheFile.setEnabled( false ); 
cancelTransfer.setEnabled( true ); 


// create a file request object 
controlPanelClient.setOffset( 0 ); 
fileSelection = fileChoiceField.getTextQ); 
if( !retrieveFailedTransfers ){ 
fileRequest = new PFTPFileRequest( FILE_REQUEST_TYPE, 
fileSelection, 
new String("" ), 0, 
new Integer( 
packetSizeSelection ). 
intValue() ); 
} else { 
fileRequest = ( PFTPFileRequest ) 
oldPartialTransferRequests.get( fileSelection ); 


} /lend if else 


try{ 
controlPanelClient.setAskTheFile( true ); 
} catch( Exception e ){ 

JOptionPane.showMessageDialog( null, "Problem in asking the file" + 
fileNameToAsk, "Exception", 
JOptionPane.ERROR_MESSAGE ); 

} //end try catch block 


} else if( !fileSelected ){ 
if( serverSelected && packetSizeSelected ){ 
JOptionPane.showMessageDialog( null, 
"Please select server, file and packet size first!" ); 
} else if( !serverSelected && !packetSizeSelected ){ 
JOptionPane.showMessageDialog( null, 
"Please select server, file and packet size first!" ); 
} else if( !serverSelected ){ 
JOptionPane.showMessageDialog( null, 
"Please select the server and a file first!" ); 
} else if( !packetSizeSelected ) { 
JOptionPane.showMessageDialog( null, 
"Please select a file and a packet size first!" ); 
} /end if else if 
} else if( serverSelected && !packetSizeSelected ){ 
JOptionPane.showMessageDialog( null, 
"Please select packet size first!" ); 
} else if( !serverSelected && packetSizeSelected ){ 
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))s 


JOptionPane.showMessageDialog( null, 
"Please select server first!" ); 
} else if( !serverSelected && !packetSizeSelected ){ 
JOptionPane.showMessageDialog( null, 
"Please select the server and packet size first!" ); 
} /end if else if 
} //end actionPerformed() method 
} /fend ActionListener class 
); /end addActionListener() method 
askTheFile.setEnabled( false ); 


add( askTheFile ); 


// constructs the stop transfer button 
cancelTransfer = new JButton( "Cancel Download" ); 
cancelTransfer.setFont( new Font( null, Font.BOLD, PANEL_LABEL_FONT_SIZE 


cancelTransfer.setForeground( FONT_COLOR ); 
cancelTransfer.setHorizontalTextPosition( JButton.LEFT ); 
cancelTransfer.setBackground( BACKGROUND_COLOR ); 
cancelTransfer.setEnabled( false ); 
cancelTransfer.addActionListener( new ActionListener() { 
public void actionPerformed( ActionEvent event ){ 
int option = JOptionPane.showOptionDialog( null, 

"Are you sure you want to cancel " + 

" download?", "Warning", JOptionPane. YES_NO_OPTION, 

JOptionPane.QUESTION_MESSAGE, null, null 

, null ); 


if( option == JOptionPane.OK_OPTION ){ 
controlPanelClient.cancelFileTransfer(); 
resetApplication(); 
} end if 
} //end actionPerformed() method 
} //end ActionListener class 
); /end addActionListener() method 


add( cancelTransfer ); 


controlPanelClient.addPanel( this ); 
controlPanelClient.addPanel( this ); 


setVisible( true ); 
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} //fend constructor 


[** 

* Sets the fileSelected value 

ok 

* @param state the the fileSelected boolean value 
i 

public void setFileSelected( boolean state ){ 


fileSelected = state; 


} lend setFileSelected() method 


[** 

* Resets the panel 

8 

public void reset() { 
//reset all the panel components 
filesFromServer.setEnabled( true ); 
filesFromServer.setSelected( true ); 
previousFailedFiles.setEnabled( true ); 
manualServerSelection.setEnabled( true ); 
predefinedServerSelection.setEnabled( true ); 
predefinedServerSelection.setSelected( true ); 
manualSelectServer.setEnabled( false ); 
selectServer.setEnabled( false ); 
serverModeChoiceBox.setEnabled( true ); 
retreiveAvailableFiles.setEnabled( false ); 
packetSizeChoiceBox.setEnabled( false ); 
askTheFile.setEnabled( true ); 
cancelTransfer.setEnabled( false ); 
fileSelected = false; 
serverSelected = false; 
packetSizeSelected = false; 
filelsTransfering = false; 

} //end reset() method 

} //end ControlPanel class 


[** 


* Provide a transfer progress panel to monitor the progress of file transfer 
a 
private class TransferProgressPanel extends JPanel{ 


/** The PFTP Client of the transfer progress panel */ 
private PFTPClient transferProgressPanelClient; 
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/** The download message panel */ 
private JPanel downloadMessagePanel; 


/** The download message */ 
private JLabel downloadMessage; 


/** The progress bar panel */ 
private JPanel progressBarPanel; 


/** The progress bar */ 
private JProgressBar progressBar; 


/** The panel with the download percentage panel */ 
private JPanel downloadPercentagePanel; 


/** The file downloading message */ 
private JLabel downloadPercentage; 


/** The file downloading message */ 
private String fileToTransfer; 


[** 

* The default constructor 

k 

* @param client the PFTPClient object 

*f 

public TransferProgressPanel( PFTPClient client ){ 
super(); 


transferProgressPanelClient = client; 


setBorder( BorderFactory.createLineBorder( PANEL_BORDER_COLOR ) ); 
setBackground( BACKGROUND_COLOR ); 
setLayout( new GridLayout( 5, 1 ) ); 


// construct textfield with default sizing 

add( getTitledPanel( "TRANSFER PROGRESS", PANEL_TITLE_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, true, true ) ); 





transferProgressPanelClient.addPanel( this ); 
downloadMessagePanel = new JPanel(); 


downloadMessagePanel.setBackground( BACKGROUND_COLOR ); 
downloadMessage = new JLabel( "No file is downloading" ); 
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downloadMessage.setFont( new Font( null, Font.BOLD, 
PANEL_LABEL_FONT_SIZE ) ); 

downloadMessage.setForeground( FONT_COLOR ); 

downloadMessagePanel.add( downloadMessage ); 

add( downloadMessagePanel ); 


progressBar = new JProgressBar(); 
progressBar.setBackground( new Color( 207, 233, 245 ) ); 
//progressBar.setBorderPainted(true); 

add( progressBar ); 


downloadPercentagePanel = new JPanel(); 

downloadPercentagePanel.setBackground( BACKGROUND_COLOR ); 

downloadPercentage = new JLabel(); 

downloadPercentage.setFont( new Font( null, Font. BOLD, 
PANEL_LABEL_FONT_SIZE ) ); 

downloadPercentage.setForeground( FONT_COLOR ); 

downloadPercentagePanel.add( downloadPercentage ); 

add( downloadPercentagePanel ); 


setVisible( true ); 
} // end constructor 


[** 

* Sets the progress bar 

ES 

* @param max the progress bar max 

nf 

public void setProgressBarMax( int max ){ 
progressBar.setMinimum( 0 ); 
progressBar.setMaximum( max ); 

} //end setProgressBarMax() method 


[** 


* Updates the progress bar 
ES 


* @param value the progress bar value 
=/ 
public void updateProgressBar( int value ){ 


if( transferProgressPanelClient.getFileIsTransfering() ){ 

Swing Utilities.invokeLater( new UpdateLabel( downloadMessage, 
"Downloading file " + 
transferProgressPanelClient.getFileNameToAsk() ) ); 

} else{ 
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SwingUtilities.invokeLater( new UpdateLabel( downloadMessage, 
"No file is downloding" ) ); 


} 


SwingUtilities.invokeLater( new UpdateProgressBar( progressBar, value ) ); 
SwingUtilities.invokeLater( new UpdateLabel( downloadPercentage, 
Math.floor( ( ( double ) value / 
progressBar.getMaximum() ) * 100) +" %" ) ); 


} //end updateProgressBar() method 


[** 
* Resets the transfer progress panel 
sa | 
public void reset() { 
SwingUtilities.invokeLater( new UpdateLabel( downloadMessage, 
"No file is downloding" ) ); 
SwingUtilities.invokeLater( new UpdateProgressBar( progressBar, 0 ) ); 
Swing Utilities.invokeLater( new UpdateLabel( downloadPercentage, "" ) ); 


} //end reset() method 


} //end TransferProgressPanel class 


[** 


* Provide a transfer status panel to monitor the file transfer status 
#/ 
private class TransferStatusPanel extends JPanel { 


/** The panel that shows the transfer status */ 
private PFTPClient transferStatusPanelClient; 


/** The transfer status panel title */ 
private JTextPane transferStatusPanelTitle; 


/** The file asked info */ 
private JTextPane fileAskedInfo; 


/** The file size info */ 
private JTextPane fileSizeInfo; 


/** The packet size used info */ 
private JTextPane packetSizeUsedInfo; 


/** The connection status info */ 
private JTextPane connectionStatusInfo; 
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/** The connection loss number info */ 
private JTextPane connectionLossNumberInfo; 


/** The total file transfer time info */ 
private JTextPane totalFileTransferTimelInfo; 


[** 

* The default constructor 

ES 

* @param client the PFTPClient object 

*/ 
public TransferStatusPanel( PFTPClient client ){ 

super(); 


transferStatusPanelClient = client; 
setBorder( BorderFactory.createLineBorder( PANEL_BORDER_COLOR ) ); 


fileAskedInfo = getTitledPanel( "No file asked", PANEL_LABEL_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ); 
fileAskedInfo.setForeground( FONT_COLOR ); 


fileSizeInfo = getTitledPanel( "", PANEL_LABEL_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ); 
fileSizeInfo.setForeground( FONT_COLOR ); 


packetSizeUsedInfo = getTitledPanel( '"", PANEL_LABEL_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ); 
packetSizeUsedInfo.setForeground( FONT_COLOR ); 


connectionStatusInfo = getTitledPanel( "Disconnected", 
PANEL _LABEL_FONT_SIZE, FONT_COLOR, 
BACKGROUND_COLOR, false, true ); 
connectionStatusInfo.setForeground( FONT_COLOR ); 


connectionLossNumberInfo = getTitledPanel( "0", 
PANEL_ LABEL FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ); 

connectionLossNumberInfo.setForeground( FONT_COLOR ); 


totalFileTransferTimeInfo = getTitledPanel( "0 msec", 
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PANEL_LABEL_FONT_SIZE, 

FONT_COLOR, 

BACKGROUND_COLOR, false, true ); 
totalFileTransferTimeInfo.setForeground( FONT_COLOR ); 


setBackground( BACKGROUND_COLOR ); 
setLayout( new GridLayout( 7, 2 ) ); 


add(_ getTitledPanel( "TRANSFER STATUS", PANEL_TITLE_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, true, true ) ); 


add( getTitledPanel( "", PANEL_LABEL_FONT_SIZE, FONT_COLOR, 
BACKGROUND_COLOR, false, true ) ); 


add( getTitledPanel( "File asked :", PANEL_LABEL_FONT_SIZE, FONT_COLOR, 
BACKGROUND_COLOR, false, true ) ); 


add( fileAskedInfo ); 


add( getTitledPanel( "File size :", PANEL_LABEL_FONT_SIZE, FONT_COLOR, 
BACKGROUND_COLOR, false, true ) ); 


add( fileSizeInfo ); 

add( getTitledPanel( "Packet size used :", PANEL_LABEL_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ) ); 

add( packetSizeUsedInfo ); 

add( getTitledPanel( "Connection status :", PANEL_LABEL_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ) ); 

add( connectionStatusInfo ); 

add( getTitledPanel( "Connection loss number :", PANEL_LABEL_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ) ); 

add( connectionLossNumberInfo ); 

add( getTitledPanel( "Total transfer time:", PANEL_LABEL_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ) ); 
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add( totalFileTransferTimelInfo ); 


setVisible( true ); 
this.setEnabled( false ); 


} //fend constructor 


[** 
* Updates file transfer's status 
sa 
public void updateFileTransferStatus() { 


SwingUtilities.invokeLater( new UpdateTextPane( fileAskedInfo, 
transferStatusPanelClient.getFileNameToAsk() ) ); 


SwingUtilities.invokeLater( new UpdateTextPane( fileSizeInfo, 
new Integer( 
transferStatusPanelClient.getFileSize() ).toString() ) ); 


SwingUtilities.invokeLater( new UpdateTextPane( packetSizeUsedInfo, 
new Integer( 
transferStatusPanelClient.getPacketSize() ).toString() ) ); 


String connectStatus = transferStatusPanelClient.getConnectionStatus(); 
if( connectStatus.equals( CONNECTED ) ){ 

Swing Utilities.invokeLater( new UpdateTextPane( connectionStatusInfo, 
connectStatus +" with " + 
transferStatusPanelClient.getServerSelected() ) ); 

} else { 

Swing Utilities.invokeLater( new UpdateTextPane( connectionStatusInfo, 

connectStatus ) ); 


} 


Swing Utilities.invokeLater( new UpdateTextPane( connectionLossNumberInfo, 
new Integer( 
transferStatusPanelClient.getConnectionLossTimes() ).toString() ) ); 


Swing Utilities.invokeLater( new UpdateTextPane( totalFileTransferTimeInfo, 
new Long( 
transferStatusPanelClient.getTotalFileTransferTime() ).toString() + 
"msec" ) ); 
} //end updateFileTransferStatus() method 


[** 
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* Resets the panel 
**/ 
public void reset() { 


SwingUtilities.invokeLater( new UpdateTextPane( fileAskedInfo, 
"No file asked" ) ); 


SwingUtilities.invokeLater( new UpdateTextPane( fileSizeInfo, "" ) ); 
SwingUtilities.invokeLater( new UpdateTextPane( packetSizeUsedInfo, "" ) ); 


SwingUtilities.invokeLater( new UpdateTextPane( connectionStatusInfo, 
"Disconnected" ) ); 


SwingUtilities.invokeLater( new UpdateTextPane( connectionLossNumberInfo, 
"oO" ) ); 


SwingUtilities.invokeLater( new UpdateTextPane( totalFileTransferTimelInfo, 
"0 sec" ) ); 


} //end reset() method 


} 


[** 


* Provide a image progress panel to view the partial file transferred 
*/ 
private class ImageProgressPanel extends JPanel { 


/** The PFTPClient object assosiated with this panel */ 
private PFTPClient imageProgressPanelClient; 


/** The image progress label */ 
private JLabel imageProgressLabel; 


/** The updated times */ 
private int updatedTimes; 


/** The fileNameToPreview */ 
private String fileNameToPreview; 


pe 


* Constructor 
ok 


* @param client the PFTPClient object assosiated with this panel 
eI 
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public ImageProgressPanel( PFTPClient client ){ 
super(); 


imageProgressPanelClient = client; 
updatedTimes = 0; 
fileNameToPreview = null; 


setBorder( BorderFactory.createLineBorder( PANEL_BORDER_COLOR ) ); 
setBackground( BACKGROUND_COLOR ); 
setLayout( new BorderLayout( 2, 1 ) ); 


Icon noPreview = new ImageIcon( LOGO_IMAGE ); 
imageProgressLabel = new JLabel( noPreview ); 
imageProgressLabel.setForeground( FONT_COLOR ); 
imageProgressLabel.setHorizontalTextPosition( JLabel.CENTER ); 
imageProgressLabel.setVerticalTextPosition( JLabel. BOTTOM ); 
add( imageProgressLabel ); 


setVisible( true ); 
} //end constructor 


[** 

* Updates the iamage progress panel 

ES 

* @param fileBytes the file byte array to display 

af 

public void updateImageProgress( byte[] fileBytes ){ 


try 


byte[] currentImageBytes = fileBytes; 

int fileLength = currentImageBytes.length; 

byte[] endOfFile = ( new String(";" ) ).getBytesQ; 

int endOfFileLength = endOfFile.length; 
ByteArrayOutputStream baos = new ByteArrayOutputStream(); 
baos.write( currentImageBytes, 0, fileLength ); 

baos.write( endOfFile, 0, endOfFileLength ); 
currentImageBytes = baos.toByteArray(); 

baos.close(); 


Swing Utilities.invokeLater( new UpdateImageLabel( imageProgressLabel, 


"Preview of file " + imageProgressPanelClient.getFileNameToAsk(), 
new Imagelcon( currentImageBytes ) ) ); 
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} catch( Exception e ){ 
System.out.println( e ); 


} 


} ///end updateImageProgress() method 


[** 
* Resets the panel 
sat 
public void reset() { 
Swing Utilities.invokeLater( new UpdateImageLabel( imageProgressLabel, 


ve 


new ImageIcon( LOGO_IMAGE ) ) ); 


} /fend reset() method 
} //fend ImageProgressPanel 


[** 

* Updates a label given dynamically 

*/ 

public class UpdateLabel extends Thread { 


/** The label to update */ 
private JLabel label; 


/** The text to set on the label */ 
private String text; 


[** 

* Constructor 

* @param | the label 

* @param t the text to set on the label 
| 

public UpdateLabel( JLabel 1, String t ){ 
label = 1; 
text = t; 

} //end constructor 


// method called to update label 
public void run({ 
label.setText( text ); 
} //fend run() method 
} //end class UpdateLabel 


[** 
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* Updates a image label given dynamically 
ih 
public class UpdateImageLabel extends Thread { 


/** The label to uadate */ 
private JLabel label; 


/** The text to set on the label */ 
private String text; 


/** The icon to set on the label */ 
private Icon icon; 


[** 
* Constructor 
* @param | the label 
* @param t the text to set on the label 
* @param i the icon to set on the label 
*/ 
public UpdateImageLabel( JLabel 1, String t, Imagelcon 1 ){ 
label = 1; 
text = t; 
icon =1; 
} //end constructor 


// method called to update label 

public void run(){ 
label.setText( text ); 
label.setIcon( icon ); 

} //fend run() method 


} // end class UpdateImageLabel 


[** 


* Updates a image text pane given dynamically 
a 
public class UpdateTextPane extends Thread { 


/** The text pane to update */ 
private JTextPane textPane; 


/** The text to set on the text pane */ 
private String text; 


[** 


* Constructor 
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* @param jtp the text tp update 
* @param t the text to set on the text pane 
sy 
public UpdateTextPane( JTextPane jtp, String t ){ 
textPane = jtp; 
text = t; 
} //end constructor 


// method called to update text pane 

public void run({ 
textPane.setText( text ); 

} //end run(Q) method 


} // end class UpdateTextPane 


[** 

* Updates a progess bar 

*f 
public class UpdateProgressBar extends Thread { 


/** The progress bar to update */ 
private JProgressBar progressBar; 


/** The value to set for the progress bar */ 
private int progressBarValue; 


[** 
* Constructor 
* @param bar the progress bar to update 
* @param value the value to set for te progress bar 
7 
public UpdateProgressBar( JProgressBar bar, int value ){ 
progressBar = bar; 
progressBarValue = value; 
} //fend constructor 


// method called to update progress bar 
public void run(){ 

progressBar.setValue( progressBarValue ); 
} //end run() method 


} // end class UpdateProgressBar 


[** 


* Displays a dialog with a file list to choose from 
*/ 
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private class FileSelectionDialog extends JDialog { 


/** The dialog client */ 
private PFTPClient dialogClient; 


/** The dialog control panel */ 
private ControlPanel dialogControlPanel; 


/** The dialog text field */ 
private JTextField dialogTextField; 


/** The item list */ 
private String[] itemList; 


/** The dialog combo box */ 
private JComboBox dialogComboBox; 


/** The dialog button */ 
private JButton dialogButton; 


/** The dialog selection */ 
private String dialogSelection; 


[** 
* Constructor 
ES 
* @param client the PFTPClientPPC object assosiated with 
* @param panel the ControlPanel object assosiated with 
* @param fileField the dialog field to set 
* @param list the list of items to choose 
ee 
public FileSelectionDialog( PFTPClient client, 
ControlPanel panel, 
JTextField fileField, 
String[] list 
4 


super( client, "Choose a file to transfer", true ); 


dialogClient = client; 

dialogControlPanel = panel; 

dialogTextField = fileField; 

itemList = list; 

dialogSelection = null; 

setBackground( BACKGROUND_COLOR ); 
setSize( 300, 180 ); 

this.setLocation( 392, 134 ); 
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Container c = getContentPane(); 
c.setLayout( new GridLayout( 5, 3 ) ); 
// just to fill the empty cell 


for( int i = 0; 1 < 4; 14+ ){ 
dialogClient.addPanel( c ); 
} 


// construct textfield with default sizing 
dialogComboBox = new JComboBox( itemList ); 
dialogComboBox.setFont( new Font( null, Font.BOLD, 
PANEL_LABEL_FONT_SIZE ) ); 
dialogComboBox.setBackground( BACKGROUND_COLOR ); 
dialogComboBox.setForeground( FONT_COLOR ); 
dialogComboBox.setEnabled( true ); 
dialogComboBox.addItemListener( 


// anonymous inner class to handle JComboBox events 
new ItemListener(){ 


// handle JComboBox event 
public void itemStateChanged( ItemEvent event ){ 
// determine whether check box selected 
if( event.getStateChange() == ItemEvent.SELECTED ){ 
dialogSelection = itemList[dialogComboBox. 
getSelectedIndex()]; 
} 


} 
} //end anonymous inner class 
); // end call to addItemListener 
c.add( dialogComboBox ); 
for( int 1 = 0; i < 5; i++ ){ 
dialogClient.addPanel( c ); 
} 
// constructs the ok button 
dialogButton = new JButton( "OK" ); 


dialogButton.setFont( new Font( null, Font. BOLD, PANEL_LABEL_FONT_SIZE ) 


dialogButton.setForeground( FONT_COLOR ); 
dialogButton.setHorizontalTextPosition( JButton.LEFT ); 
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dialogButton.setBackground( BACKGROUND_COLOR ); 
dialogButton.addActionListener( new ActionListener(){ 
public void actionPerformed( ActionEvent event ){ 
if( dialogSelection == null ){ 
dialogControlPanel.setFileSelected( false ); 
JOptionPane.showMessageDialog( null, 
"No file selected!", 


null, 
JOptionPane. INFORMATION_MESSAGE, 


null ); 


} else{ 
dialogTextField.setText( dialogSelection ); 
dialogControlPanel.setFileSelected( true ); 
set Visible( false ); 

} /end if else 

} //end actionPerformed() method 
} fend ActionListener class 
); /end addActionListener() method 


c.add( dialogButton ); 
for( int i = 0; i < 4; 14+ ){ 


dialogClient.addPanel( c ); 
} 


showQ(); 
} //fend constructor 


} //end FileSelectionDialog class 


} //end PFTPClient class 
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//packages for network componets 
import java.io.*; 
import java.net.*; 


//packages for user interface components 
import java.awt.*; 

import java.awt.event.*; 

import java.util.*; 


//package for security components 
import java.security.*; 


//package for charecter encoding components 
import sun.misc.*; 


/ ok 
* File PFTPClientPPC. java 
* 


* This is a FTP Client for the Pocket PC version 

ES 

* This client also ask for a file and stays in a loop keep asking 
* until it gets it all. In the first request it receives the 

* hash value of the requested file so when the connection is 
* lost client can ask an other server the same file with out 

* worrying about the authenticity of it. 

* 

* @author LT Periklis Pantoleon 

* @version 1.0 

a | 

class PFTPClientPPC extends Frame { 


// 


/** The default port where the FTP client is asking the server */ 
private static final int FTP_PORT = 6789; 


/** The string array with the valid servers can be chosen */ 
private static final String[] VALID_SERVERS = { 
"127.0.0.1", "131.120.105.237", "131.120.105.250", "131.120.201.46"}; 


/** The packet size array with the packet sizes can be chosen */ 
private String[] PACKET_SIZES = {new String( "32" ), 
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new String( "64" ), new String("128" ), 
new String('"256" ), new String( "512" ), 
new String( "1024" )}; 


/** The connected status */ 
private static final String CONNECTED = "Connected"; 


/** The disconnected status */ 
private static final String DISCONNECTED = "Disconnected"; 


/** The status when the client is trying to connect */ 
private static final String TRYING_TO_CONNECT = "Trying to connect....."; 


/** The timeout period of the TCP sockets */ 
private static final int SO_TIME_OUT = 3000; 


/** The length in bytes of the file hash value */ 
private static final int MD5_HASH_LENGTH = 16; 


/** The font size for the panels' titles */ 
private static final int PANEL_TITLE_FONT_SIZE = 17; 


/** The font size for the panels’ labels */ 
private static final int PANEL_LABEL_FONT_SIZE = 12; 


/** The panels’ font color */ 
private static final Color FONT_COLOR = Color.white; 


/** The color of the backgroung of the frames and panels */ 
private static final Color BACKGROUND_COLOR = new Color( 77, 92, 240 ); 


/** The color of the panels’ border */ 
private static final Color PANEL_BORDER_COLOR = Color.blue; 


/** The maximum reconnection tries each time client lose connection*/ 
private static final int MAX_RECONNECTION_TRIES = 3; 


/** The maximum reconnection tries each time client lose connection */ 
private static final int MAX_TOTAL_TRIES = 3; 


/** The times tht the image is updated in the image progress panel */ 
private static final int IMAGE_UPDATE_TIMES = 10; 


/** The request type when a file is asked */ 
private static final int FILE_REQUEST_TYPE = 1; 
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/** The request type when a file array is asked */ 
private static final int FILE_ARRAY_REQUEST_TYPE = 0; 


/** The type for the message dialog */ 
private static final int MESSAGE_DIALOG_TYPE = 1; 


/** The type for the yes-no dialog */ 
private static final int YES_NO_DIALOG_TYPE = 0; 


/** The message dialog OK option */ 
private static final int YES_OPTION = 1; 


/** The message dialog NO option */ 
private static final int NO_OPTION = 0; 


/** The file name of the logo image of the client frame */ 
private static final String LOGO_IMAGE = "pftpLogoClient. gif"; 
// 


// 


/** The socket client use to communicate with the server */ 
private Socket clientSocket; 


/** The object input stream to receive objects from client */ 
private ObjectInputStream inObjectFromServer; 


/** The object output stream to send objects to client */ 
private ObjectOutputStream outObjectToServer; 


/** The file request received from client */ 
private PFTPFileRequest fileRequest; 


/** The vector that store that old partial file bytes */ 
private Vector oldPartialTransferRequests; 


/** The vector that store that old partial file bytes */ 
private Vector oldPartialTransfersB ytes; 


/** The vector of the file names that failed to downloaded */ 
private Vector oldPartialTransfersFiles; 


/** The vector list of the files available on PFTP server */ 
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private Vector serverAvailableFiles; 


/** The name of the asked file */ 
private String fileNameToAsk; 


/** The server mode selected */ 
private String serverMode; 


/** The server selected */ 
private String serverSelected; 


/** The hash value of the file asked */ 
private String fileHash; 


/** The size in bytes of the file asked */ 
private int fileSize; 


/** The offset from where we need the file */ 
private int offset; 


/** The packet size used for the file transfer */ 
private int packetSize; 


/** The file as a byte array */ 
private byte[] fileInBytes = null; 


/** The packet counter */ 
private int packetCounter; 


/** The number of packets used for the file*/ 
private int numOfPackets; 


/** The start time of the file reception */ 
private long startTime; 


/** The end time of the file reception */ 
private long stopTime; 


/** The total file transfer time */ 
private long totalFileTransferTime; 


/** The connection status */ 
private String connectionStatus; 


/** The connection loss times */ 
private int connectionLossTimes; 
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/** The connection loss times */ 
private int messageOption; 


/** The boolean value of the intetion of the user to ask a file */ 
private boolean wantFile; 


/** The boolean value if the file is transfered or not */ 
private boolean fileTransfered; 


/** The boolean value the file transfer is canceled or not */ 
private boolean cancelFileTransfer; 


/** The boolean value if user wants to retreive failed transferred files */ 
private boolean retrieveFailedTransfers; 


/** The file name for the partial retreived file */ 
private String partialRetreivedFileName; 


// 
/** The container of the main frame */ 
private Container container; 


/** The the layout manager of the container */ 
private GridLayout layout; 


/** The control panel */ 
private ControlPanel controlPanel; 


/** The panel that shows the transfer status during downloading */ 
//private TransferStatusPanel transferStatusPanel; 


/** The panel that displays the image during the downloading */ 
private ImageProgressPanel imageProgressPanel; 


/** The boolean tranfering status */ 
private boolean fileIsTransfering = false; 


/** The boolean value if user want to download the file or not */ 
private boolean askTheFile = false; 
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// 

// Constructor: 

// 

//----------------------------------------- 
[** 


* Default constructor 
*/ 
public PFTPClientPPC() { 


super( "PFTP PocketPC 1.0" ); 
FrontDialog fd = new FrontDialog( this ); 
// set the layout of the container 

layout = new GridLayout( 1, 1 ); 
setLayout( layout ); 

// add the panels on the main frame's panels 


add( controlPanel ); 


addWindowListener( new WindowListener(){ 
public void windowOpened( WindowE vent event ){ 


} 


public void windowClosed( WindowEvent event ){ 
System.exit( 0 ); 
} 


public void windowClosing( WindowEvent event ){ 
System.exit( 0 ); 
} 


public void windowIconified( WindowEvent event ){ 


} 


public void windowDeiconified( WindowEvent event ){ 


} 


public void windowActivated( WindowEvent event ){ 


} 


public void windowDeactivated( WindowEvent event ){ 


} 
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})s 


//sets other attributes of the main frame 
setSize( 240, 300 ); 
setVisible( true ); 


/Anitialization of the private members 
oldPartialTransferRequests = new Vector(); 
oldPartialTransfersBytes = new Vector(); 
oldPartialTransfersFiles = new Vector(); 
serverA vailableFiles = new Vector(); 


fileNameToAsk = null; 

fileSize = 0; 

packetSize = 0; 

fileHash = ""; 

connectionStatus = DISCONNECTED; 
retrieveFailedTransfers = false; 
connectionLossTimes = 0; 
totalFileTransferTime = 0; 

askTheFile = false; 


} // end default constructor 


[** 


* Opens the streams for communicating with the client 
* 


* @throws IOException when the outpu/input stream can not be openned 
*/ 
private void openStreams() throws IOException { 


// open the sreams needed 
inObjectFromServer = new ObjectInputStream( clientSocket.getInputStream() ); 
outObjectToServer = new ObjectOutputStream( clientSocket.getOutputStream() ); 


} // end openStreams() method 


[** 


* Selects one from the valid server to try connecting 
ES 


* @return a string IP address of the server 
| 
private String selectServer() { 


String serverToReturn; 
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double random = 10 * Math.random(); 

int randomIndex = ( int ) random; 

serverToReturn = VALID_SERVERS|[randomIndex % VALID_SERVERS. length]; 
return serverToReturn; 


} // end selectServer() method 


[** 

* Selects one from the valid server to try connecting 

* 

* @return a string IP address of the server 

* @throws IOException 

* @throws ClassNotFoundException 

| 

private Vector getServerAvailableFiles() throws IOException, 
ClassNotFoundException{ 


boolean exit = false; 
boolean connected = false; 
int serverIndex = 0; 


if( serverMode == "Auto select" ) { 
while( !connected && ( serverIndex < VALID_SERVERS. length ) ){ 
serverSelected = VALID_SERVERS|[serverIndex]; 
System.out.printIn( "server : "+ serverSelected ); 
serverIndex++; 
try 
clientSocket = new Socket( serverSelected, FTP_PORT ); 
connected = true; 
} catch( IOException ioe ){ 
} //end try catch block 
} //end while 
if( !connected ){ 
clientSocket = new Socket( serverSelected, FTP_PORT ); 


} 
} else{ 
clientSocket = new Socket( serverMode, FTP_PORT ); 


} 


openStreams(); 
connectionStatus = CONNECTED; 
fileRequest = new PFTPFileRequest( FILE_ARRAY_REQUEST_TYPE, 
new String(), 
new String(), 
0, 
0); 
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//send the file request object to the server 
outObjectToServer.writeObject( fileRequest ); 
outObjectToServer.flush(); 
Vector filesAtServer = ( Vector ) inObjectFromServer.readObject(); 
serverAvailableFiles = new Vector(); 
for( int i = 0; 1 < filesAtServer.sizeQ); i++ ){ 

serverA vailableFiles.add( filesAtServer.elementAt( i ) ); 
} 
System.out.println( "Files at server : " + serverAvailableFiles ); 
clientSocket.close(); 


connectionStatus = DISCONNECTED; 
return serverAvailableFiles; 


} // end selectServer() method 


[** 


* Sends a file request package to the server asking for a file 
ES 
* @param fileRequest the file request 
* @throws Exception 
a | 
public void askForFile( PFTPFileRequest fileRequest ) throws Exception{ 
// some variable initialization 
boolean fileNotFound = false; 
fileTransfered = false; 
cancelFileTransfer = false; 
packetCounter = 0; 
int byteCounter = 0; 
int numOfBytes = 1; 
int percent = 0; 
numOfPackets = 1; 
fileNameToAsk = fileRequest.getFileQ); 
boolean firstIteration = true; 


// create a file to receive 
fileNameToAsk = fileRequest.getFileQ; 
File file = new File( fileNameToAsk ); 
int connectionCounter = 1; 

int imagePacketUpdate = 0; 

int imagePacketUpdateCounter = 1; 


if( retrieveFailedTransfers ){ 
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offset = fileRequest.getOffset(); 

fileHash = fileRequest.getHash(); 

packetCounter = offset; 

numOfPackets = packetCounter + 1; 
} /end if 


// The loop that keep asking the file till gets it all 
while( !cancelFileTransfer && !fileTransfered && !fileNotFound && 
( packetCounter < numOfPackets ) && 
( connectionCounter <= ( MAX RECONNECTION_TRIES * 


MAX_TOTAL_TRIES ) ) ){ 


System.out.printIn( "while" ); 
if( ¢( ( MAX _RECONNECTION_TRIES * MAX_TOTAL_TRIES ) % 


connectionCounter ) == 
1 
delay( 2000 ); 
} else { 
delay( 2000 ); 
} /end if else 
connectionCounter++; 


try{ 
if( serverMode.equals( new String( "Auto select" ) ) ){ 
//select a valid server to try connect 


if( !firstIteration ){ 


serverSelected = selectServer(); 


} 
} else{ 


serverSelected = serverMode; 
} //end if 


System.out.printIn( "Trying to connect to the server...." + serverMode ); 
delay( 1000 ); 


//connect to the server selected and set the time out period 
clientSocket = new Socket( serverSelected, FTP_PORT ); 
clientSocket.setSoTimeout( SO_TIME_OUT ); 


connectionStatus = CONNECTED; 
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System.out.printIn( "Client connected!" ); 


try { 
openStreams(); 
} catch( Exception ioe ){ 


MessageDialog md = new MessageDialog( this, 
controlPanel, 
"ek Exception **", 
MESSAGE_DIALOG_TYPE, 
"Client: Failed to open streams" ); 


} // end try catch block 


fileRequest.setOffset( offset ); 
fileRequest.setHash( fileHash ); 


//send the file request object to the server 
outObjectToServer.writeObject( fileRequest ); 
outObjectToServer.flush(); 


imageProgressPanel = new ImageProgressPanel( this ); 


if( offset == 0 ){ 
//receive the file hash value if it is asked for the first time 
fileHash = inObjectFromServer.readUTF(Q); 
System.out.printIn( "Hash value received " + fileHash ); 
} //end if 


if( !fileHash.equals( new String( "fileNotFound" ) ) && 
!fileHash.equals( new String( "hashProblem" ) ) && 
!fileHash.equals( new String( "fileNotMatch" ) ) ){ 


//receive the file size from the server 

fileSize = inObjectFromServer.readInt(); 

System.out.printIn( "File size to receive " + fileSize + " bytes" ); 
numOfPackets = ( fileSize / packetSize ) + 1; 

imagePacketUpdate = numOfPackets / ( IMAGE_UPDATE_TIMES - 1 ); 


if( packetCounter == 0 ){ 


//Anitialize a byte array for the file bytes 
fileInBytes = new byte[fileSize + packetSize]; 


} else if( retrieveFailedTransfers && firstIteration ){ 
firstIteration = false; 
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byte[] partialBytes = ( byte[] ) oldPartialTransfersBytes.elementAt( 
oldPartialTransfersFiles.indexOf( fileNameToAsk ) ); 

ByteArrayOutputStream baos = 
new ByteArrayOutputStream( fileSize + packetSize ); 

baos.write( partialBytes, 0, partialBytes.length ); 

fileInBytes = baos.toByteArray(); 

baos.close(); 

byteCounter = packetSize * offset; 

} /end if else if 


byte[] newPacket = new byte[packetSize]; 


try{ 
if( packetCounter == 0 ){ 
startTime = System.currentTimeMillis(); 
} /end if 


filelsTransfering = true; 


//receiving the packets and updating the file byte array 

while( !cancelFileTransfer && ( packetCounter < numOfPackets ) ){ //end if 
offset = packetCounter; 
inObjectFromServer.read( newPacket ); 


for( int 1 = 0; 1 < packetSize; i++ ){ 
fileInBytes[byteCounter + i] = newPacket[i]; 
} //end for loop 
System.out.printIn( "Bytes "+ ( byteCounter + 1 ) + 
"to " + ( byteCounter + packetSize ) + 
"received" ); 


percent = (int ) Math.floor( ( ( double ) byteCounter / 
fileSize ) * 100 ); 
imageProgressPanel.setTitle( percent + "% of " + fileNameToAsk + 
"received!" ); 
if( ( packetCounter % imagePacketUpdate ) == 0 ){ 
//update image progress panel 
imageProgressPanel.updateImageProgress( fileInBytes ); 
} /and if 


delay( 500 ); 
byteCounter += packetSize; 
percent = ( int ) Math.floor( ( ( double ) byteCounter / 
fileSize ) * 100 ); 
if( percent > 100 ) 
percent = 100; 
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imageProgressPanel.setTitle( percent + "% of " + fileNameToAsk + 
"received!" ); 
packetCounter++; 
} /end while loop 


} catch( IOException ioe ){ //in case of connection loss 
System.out.printIn( "Problem reading I/O Streams" ); 
connectionStatus = DISCONNECTED; 
connectionLossTimes++; 

} //end try catch block 


stopTime = System.currentTimeMillis(); 


//create the file and pass the byte array formed in it 

if( !cancelFileTransfer && packetCounter == numOfPackets ) { 
fileTransfered = true; 
outObjectToServer.writeBoolean( true ); 
outObjectToServer.flushQ); 


if( file.exists() ){ 
file.delete(); 
} else{ 


imageProgressPanel.updateImageProgress( fileInBytes ); 
imageProgressPanel.updateImageProgress( fileInBytes ); 


file = new File( fileNameToAsk ); 

FileOutputStream editFile = new FileOutputStream( file ); 

editFile.write( fileInBytes ); 

totalFileTransferTime = stopTime - startTime; 

editFile.close(); 

if( retrieveFailedTransfers ){ 
deletePartialFileRequest( fileNameToAsk ); 
retrieveFailedTransfers = false; 
deletePartialFileRequest( fileNameToAsk ); 

} /end if 


MessageDialog md = new MessageDialog( this, 
controlPanel, 
"e* Message **", 
MESSAGE _ DIALOG_TYPE, 
"File transfered in " + 
totalFileTransferTime + " msec!" ); 
if( oldPartialTransfersFiles.contains( fileNameToAsk ) ){ 
int index = oldPartialTransfersFiles.indexOf( fileNameToAsk ); 
oldPartialTransferRequests.removeElementAt( index ); 
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oldPartialTransfersBytes.removeElementAt( index ); 
oldPartialTransfersFiles.removeElementAt( index ); 


} 
imageProgressPanel.setVisible( false ); 


resetApplication(); 


} 


} else{ 
System.out.printIn( "File: " + fileNameToAsk + 
" transfer interrupted!" ); 
} /fend if else 
} else{ 
System.out.printIn( "Server doesn't have the file version asked!" ); 
} /end if else 


try{ 


System.out.printIn( "Close socket" ); 
clientSocket.closeQ; 
} catch( IOException ioe ){ 


} //end try catch block 
} catch( Exception ce ){ 
connectionStatus = ,TRYING_TO_CONNECT; 
if( connectionCounter = ( MAX_RECONNECTION_TRIES 
MAX_TOTAL_TRIES + 1 ) ){ 
MessageDialog md = new MessageDialog( this, 
controlPanel, 
™* ERROR **", 
MESSAGE_DIALOG_TYPE, 
"The server couldn't be reached " ); 


} //end if 
} //end try catch block 
} //end while loop 


if( !fileTransfered && !cancelFileTransfer ){ 
fileRequest.setOffset( offset ); 
fileRequest.setHash( fileHash ); 
savePartialFileRequest( fileRequest, 
fileInBytes ); 


MessageDialog md = new MessageDialog( this, 
controlPanel, 


"ek ERROR **", 
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MESSAGE_DIALOG_TYPE, 
"Transfer failed.Partial data stored!" ); 


} //end if 


} //fend askForFile() method 


[** 

* Cancels the file's transfer 

wd 

public void cancelFileTransfer() { 
cancelFileTransfer = true; 

} fend setFileNameToAsk() method 


[** 

* Sets the file name to ask the server 

ok 

* @param fileName the string file name 

| 

public void setFileNameToAsk( String fileName ){ 
fileNameToAsk = fileName; 

} fend setFileNameToAsk() method 


[** 
* Starts the file dowmnloading 
ES 
* @param ask true if the ask the file button is pressed 
a 
public void setAskTheFile( boolean ask ){ 
askTheFile = ask; 
} end setFileNameToAsk() method 


[** 


* Sets the server mode of the file transfer 
ok 


* @param mode the string server mode 

ad 

public void setServerMode( String mode ){ 
serverMode = mode; 

} /fend setServerMode() method 


[** 


* Sets the packet size for the file transfer 
* 


* @param sizeOfThePacket the packet size selected for the file transfer 
a 
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public void setPacketSize( int sizeOfThePacket ){ 
packetSize = sizeOfThePacket; 
} //fend setPacketSize() method 


[** 

* Sets the offset for the file transfer 
k 

* @param theOffset the offset value 
my 

public void setOffset( int theOffset ) { 
offset = theOffset; 

} //end setPacketSize() method 


[** 
* Returns the name of the file asked from the server 
* 
* @return the name of the file asked from the server 
eh 
public synchronized String getServerMode() { 
notify; 
return serverMode; 
} fend getFileNameToAsk() method 


[** 
* Returns the name of the file asked from the server 
ES 
* @return the name of the file asked from the server 
=] 
public synchronized String getFileNameToAsk() { 
notify; 
return fileNameToAsk; 
} //end getFileNameToAsk() method 


[** 

* Returns the size of the file asked from the server 
* 

* @return the size of the file asked from the server 
i) 

public synchronized int getPacketSize() { 
notify(); 
return packetSize; 

} //end getPacketSize() method 


[** 


* Returns the size in bytes of the file asked 
* 


121 


* @return the size in bytes of the file asked 
*} 

public synchronized int getFileSize() { 
notify(); 
return fileSize; 

} //end getFileSize(Q) method 


[** 

* Returns the number of packet needed for the transfer 
ES 

* @return the number of packets need for the transfer 
=) 

public synchronized int getNumOfPackets() { 
notify(); 
return numOfPackets; 

} //end getNumOfPackets() method 


[** 

* Returns the number of packet already received 
* 

* @return the number of packet already received 
cL 

public synchronized int getReceivedPackets() { 
notify(); 
return packetCounter; 

} //end getReceivedPackets() method 


[** 
* Returns the file bytes as byte array 
ES 
* @return the file bytes as byte array 
*/ 
public synchronized byte[] getFileInBytes(){ 
notifyQ; 
return fileInBytes; 
} //end getFileInBytes() method 


[** 

* Returns the connection status 

* 

* @return the connection status 

+f 

public synchronized String getConnectionStatus() { 
notify(); 
return connectionStatus; 

} //end getConnectionStatus() method 
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[** 
* Returns the connection loss times 
ok 


* @return the connection loss times 
ia 
public synchronized int getConnectionLossTimes() { 
notify(); 
return connectionLossTimes; 
} //end getConnectionLossTimes() method 


[** 
* Returns the total file transfer time 
ES 
* @return the total file transfer time 
e/ 
public synchronized long getTotalFileTransferTime() { 
notifyQ; 
return totalFileTransferTime; 
} //end getTotalFileTransferTime() method 


[** 
* Returns the total file transfer time 
* 
* @return the total file transfer time 
sa 
public synchronized boolean getFileTransfered() { 
notify(); 
return fileTransfered; 
} //end getFileTransfered() method 


[** 

* Returns the control panel 

ok 

* @return the control panel 

sa 
public synchronized ControlPanel getControlPanel() { 

notifyQ; 

return controlPanel; 

} //end getControlPanel() method 


[** 


* Adds a panel to a container 
ES 


* @param container the container to add the panel 
| 
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public void addPanel( Container container ){ 
Panel dummy = new Panel(); 
dummy.setBackground( BACKGROUND_COLOR ); 
container.add( dummy ); 

} /fend addPanel() method 


[** 


* Saves a partial file request to file request database for future use 
* 


* @param partialFileRequest the partial file request to save in database 
* @param partialFileBytes the partial file bytes to save in database 
*] 
public void savePartialFileRequest( PFTPFileRequest partialFileRequest, 
byte[] partialFileBytes ){ 


oldPartialTransfersFiles.addElement( partialFileRequest.getFileQ) ); 
oldPartialTransferRequests.addElement( partialFileRequest ); 
oldPartialTransfersBytes.addElement( partialFileBytes ); 


//oldPartialTransfersFileSizes.add(new Integer(partialFileOverallSize)); 


} //end savePartialFileRequest() method 


[** 


* Deletes a partial file request from file request database 
* 


* @param partialFileNameRequested the name of the file of the 
: request to delete from database 
*} 
public void deletePartialFileRequest( String partialFileNameRequested ){ 


oldPartialTransferRequests.removeElement( partialFileNameRequested ); 
oldPartialTransfersBytes.removeElement( partialFileNameRequested ); 
oldPartialTransfersFiles.removeElement( partialFileNameRequested ); 


} //end deletePartialFileRequest() method 


[** 
* Resets the client application 
7 | 
public void resetApplication() { 


fileSize = 0; 

fileHash = ""; 

connectionStatus = DISCONNECTED; 
connectionLossTimes = 0; 
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totalFileTransferTime = 0; 
controlPanel.reset(); 


} //end resetApplication() method 


[** 
* Starts chack for start downloading 
| 
public void startCheckToAsk() { 
while( true ){ 
delay( 50 ); 
if( askTheFile ){ 
try{ 
System.out.printIn( "File asked" ); 
askForFile( fileRequest ); 
} catch( Exception e ){ 


} 
askTheFile = false; 
} 


} 
} /lend 


[** 
* Delay the execution of the code 
* 
* @param msec the delay time in milliseconds 
i) 
public void delay( int msec ){ 
try{ 
Thread.sleep( msec ); 
} catch( InterruptedException ie ){ 
System.out.printIn( "Thead sleep interupted" ); 


} 
} //end delay() method 


[** 


* The main method 
ok 


* @param args the arguments 

* @throws Exception if exception occurs in FTPClient application 
a 

public static void main( String args[] ) throws Exception { 
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PFTPClientPPC client = new PFTPClientPPCQ; 
client.startCheckToAsk(); 


} /fend main method 


// 


[** 


* Provide a control panel to control the application 
oy 
private class ControlPanel extends Panel{ 


/** The PFTPClient class object */ 
private PFTPClientPPC controlPanelClient; 


/** The panel that displays the image during the downloading */ 
private ImageProgressPanel imagePanel; 


/** The control panel title */ 
private Panel controlPanelTitle; 


/** The file choice dialog */ 
private FileSelectionDialog fileChoiceDialog; 


/** The file choice label */ 
private Label fileChoiceLabel; 


/** The server mode choice list */ 
private java.awt.List serverModeChoiceList; 


/** The packet size choice list */ 
private java.awt.List packetSizeChoiceList; 


/** The file button group */ 
private CheckboxGroup fileButtonGroup; 


/** The server button group */ 
private CheckboxGroup serverButtonGroup; 


[** 


* The previous failed files Checkbox 
“y 
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private Checkbox previousFailedFiles; 


[** 


* The files from server Checkbox 
58 
private Checkbox filesFromServer; 


[** 

* The manual server selection Checkbox 
*/ 
private Checkbox manualServerSelection; 


[** 
* The predefined server selection Checkbox 
a 
private Checkbox predefinedServerSelection; 


/** The select server button */ 
private Button selectServer; 


/** The button to retreive the availiable file at PFTP Server */ 
private Button retreiveA vailableFiles; 


/** The button to ask for the file transfer */ 
private Button askTheFile; 


/** The button to cancel the file transfer */ 
private Button cancelTransfer; 


/** The text field to enter manual the server to ask the file from */ 
private TextField manualSelectServer; 


/** The server IP array with servers can be chosen */ 
private String[] serverIPs = {"Select server", "Auto select", 
"127.0.0.1", "131.120.105.237", "131.120.105.250", "131.120.201.46"}; 


/** The packet size array with the packet sizes can be chosen */ 
private String[] packetSizes = {"Packet size..", 

new String( "32" ), new String( "64" ), new String( "128" ), 

new String( "256" ), new String( "512" ), new String( "1024" )}; 


/** The file selected */ 
private String fileSelection; 


/** The server selected */ 
private String serverSelection; 
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/** The packet size selected */ 
private String packetSizeSelection; 


/** The boolean value if a file selected or not */ 
private boolean fileSelected = false; 


/** The boolean value if a server selected or not */ 
private boolean serverSelected = false; 


/** The boolean value if a packet size selected or not */ 
private boolean packetSizeSelected = false; 


[** 

* The default constructor 

* 

* @param panelClient the FTPClientVer7 object assosiated with 

* @param imagePanel the ImageProgressPanel object assosiated with 

*/ 

public ControlPanel( PFTPClientPPC panelClient, 
ImageProgressPanel imagePanel ){ 


super(); 


serverIPs = new String] VALID_SERVERS. length + 2]; 
for( int 1 = 0; i < serverIPs.length; i++ ){ 
if(i==0 ){ 
serverIPs[i] = "Select server"; 
} else if( i == 1 ){ 
serverIPs[i] = "Auto select"; 
} else{ 
serverIPs[i] = VALID_SERVERS[i - 2]; 
} /end if else if 
} //end for loop 


packetSizes = new String[PACKET_SIZES.length + 1]; 
for( int i = 0; 1 < packetSizes.length; i++ ){ 
if(i==0 ){ 
packetSizes[i] = "Select packet size"; 
} else{ 
packetSizes[i] = PACKET_SIZES[i - 1]; 
} /end if else if 
} //end for loop 


controlPanelClient = panelClient; 
imagePanel = imagePanel; 
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setBackground( BACKGROUND_COLOR ); 
setLayout( new GridLayout( 12, 2 ) ); 


Label controlPanelTitle = new Label( "CONTROL PANEL" ); 
controlPanelTitle.setFont( new Font( "Serif", Font. BOLD, 13 ) ); 
controlPanelTitle.setForeground( FONT_COLOR ); 

add( controlPanelTitle ); 


// just to fill the empty cells 
controlPanelClient.addPanel( this ); 


// construct textfield with default sizing 

Label fileToReceive = new Label( "File to retreive:" ); 
fileToReceive.setFont( new Font( "Serif", Font.BOLD, 13 ) ); 
fileToReceive.setForeground( FONT_COLOR ); 

add( fileToReceive ); 


fileButtonGroup = new CheckboxGroup(); 

previousFailedFiles = new Checkbox( "Failed transfers", fileButtonGroup, false ); 
previousFailedFiles.setFont( new Font( "Serif", Font.BOLD, 12 ) ); 
previousFailedFiles.setForeground( FONT_COLOR ); 

filesFromServer = new Checkbox( "Files on server", fileButtonGroup, true ); 
filesFromServer.setFont( new Font( "Serif", Font. BOLD, 12 ) ); 
filesFromServer.setForeground( FONT_COLOR ); 


//inner class to handle JRadioButton events 
ItemListener fileMode = new ItemListener() { 


// handle Checkbox event 
public void itemStateChanged( ItemEvent event ){ 
// determine whether check box selected 
if( event.getSource() == previousFailedFiles ){ 
String[] fileList = new String[oldPartialTransfersFiles.size() + 1]; 
for( int i = 0; i < fileList.length; i++ ){ 
if(i == 0 ){ 
fileList[i] = "Select file"; 
} else{ 
fileList[i] = ( String ) oldPartialTransfersFiles.elementAt( i - 
1); 
} /end if else 
} //end for loop 
if( !oldPartialTransfersFiles.isEmpty() ){ 
retrieveFailedTransfers = true; 
fileChoiceDialog = new FileSelectionDialog( controlPanelClient, 
controlPanelClient.getControlPanel(), 
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fileChoiceLabel, 

fileList ); 
packetSizeSelected = true; 

} else if( oldPartialTransfersFiles.isEmpty(Q ){ 
MessageDialog md = new MessageDialog( controlPanelClient, 
controlPanel, 

"ek Message **", 

MESSAGE_DIALOG_TYPE, 

"No file transfer failure by now!" ); 
manualServerSelection.setEnabled( false ); 
predefinedServerSelection.setEnabled( false ); 
manualSelectServer.setEnabled( false ); 
selectServer.setEnabled( false ); 
serverModeChoiceList.setEnabled( false ); 
retreiveAvailableFiles.setEnabled( false ); 
packetSizeChoiceList.setEnabled( false ); 
askTheFile.setEnabled( false ); 


} else if( event.getSource() == filesFromServer ){ 
manualServerSelection.setEnabled( true ); 
predefinedServerSelection.setEnabled( true ); 
serverModeChoiceList.setEnabled( true ); 
askTheFile.setEnabled( true ); 

} /fend if else 

} //end itemstateChanged 


}; //end anonymous inner class 


previousFailedFiles.addItemListener( fileMode ); 
previousFailedFiles.setBackground( BACKGROUND_COLOR ); 


filesFromServer.addItemListener( fileMode ); 
filesFromServer.setBackground( BACKGROUND_COLOR ); 


add( previousFailedFiles ); 

controlPanelClient.addPanel( this ); 

add( filesFromServer ); 

Label serverToReceiveFrom = new Label( "Server choice:" ); 
serverToReceiveFrom.setFont( new Font( "Serif", Font.BOLD, 13 ) ); 


server ToReceiveFrom.setForeground( FONT_COLOR ); 
add( serverToReceiveFrom ); 
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serverButtonGroup = new CheckboxGroup(); 
manualServerSelection = new Checkbox( "Manual Selection", 
serverButtonGroup, false ); 
predefinedServerSelection = new Checkbox( "Existing Servers", 
serverButtonGroup, true ); 


//Ainner class to handle JRadioButton events 
ItemListener serverListener = new ItemListener(){ 


// handle Checkbox event 
public void itemStateChanged( ItemEvent event ){ 

// determine whether check box selected 

if( event.getSource() == manualServerSelection ){ 
manualSelectServer.setEnabled( true ); 
serverModeChoiceList.setEnabled( false ); 
selectServer.setEnabled( true ); 

} else if( event.getSource() == predefinedServerSelection ){ 
manualSelectServer.setEnabled( false ); 
selectServer.setEnabled( false ); 
serverModeChoiceList.setEnabled( true ); 

} /end if else 

} //end itemstateChanged 


}; //end anonymous inner class 


manualServerSelection.addItemListener( serverListener ); 
manualServerSelection.setBackground( BACKGROUND_COLOR ); 
manualServerSelection.setFont( new Font( "Serif", Font.BOLD, 12 ) ); 
manualServerSelection.setForeground( FONT_COLOR ); 


predefinedServerSelection.addItemListener( serverListener ); 
predefinedServerSelection.setBackground( BACKGROUND_COLOR ); 


predefinedServerSelection.setFont( new Font( "Serif", Font.BOLD, 12 ) ); 
predefinedServerSelection.setForeground( FONT_COLOR ); 


add( manualServerSelection ); 
controlPanelClient.addPanel( this ); 

add( predefinedServerSelection ); 

Label addServerIP = new Label( "Select server IP:" ); 
addServerIP.setFont( new Font( "Serif", Font.BOLD, 13 ) ); 


addServerIP.setForeground( FONT_COLOR ); 
add( addServerlP ); 
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)); 


manualSelectServer = new TextField( "Enter server IP" ); 
addServerIP.setFont( new Font( "Serif", Font.BOLD, 13 ) ); 
manualSelectServer.setEditable( true ); 
manualSelectServer.setEnabled( false ); 

add( manualSelectServer ); 


controlPanelClient.addPanel( this ); 


// constructs the add server button 
selectServer = new Button( "Select the server" ); 
selectServer.setFont( new Font( "Serif", Font. BOLD, PANEL LABEL FONT_SIZE 


selectServer.setForeground( FONT_COLOR ); 
selectServer.setBackground( BACKGROUND_COLOR ); 
selectServer.setEnabled( false ); 
selectServer.addActionListener( new ActionListener() { 
public void actionPerformed( ActionEvent event ){ 


try 


String serverIP = manualSelectServer.getText(); 
InetAddress.getByName( serverIP ); 
if( !retrieveFailedTransfers ){ 
retreiveA vailableFiles.setEnabled( true ); 
} 
packetSizeChoiceList.setEnabled( false ); 
controlPanelClient.setServerMode( serverIP ); 
serverSelected = true; 
} catch( UnknownHostException uhe ){ 
MessageDialog md = new MessageDialog( controlPanelClient, 
controlPanel, 
"* INFORMATION **", 
MESSAGE_DIALOG_TYPE, 
"Select a valid server IP address!" ); 


} 


} //end actionPerformed() method 
} lend ActionListener class 
); //end addActionListener() method 


add( selectServer ); 
Label chooseServerMode = new Label( "Server mode:" ); 
chooseServerMode.setFont( new Font( "Serif", Font. BOLD, 13 ) ); 


chooseServerMode.setForeground( FONT_COLOR ); 
add( chooseServerMode ); 
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serverModeChoiceList = new java.awt.List( 4, false ); 
for( int 1 = 0; 1 < serverIPs.length; i++ ){ 

serverModeChoiceList.add( serverIPs[i] ); 
} 
serverModeChoiceList.setFont( new Font( "Serif", Font.BOLD, 

PANEL_LABEL_FONT_SIZE ) ); 

serverModeChoiceList.setBackground( BACKGROUND_COLOR ); 
serverModeChoiceList.setForeground( FONT_COLOR ); 
serverModeChoiceList.setEnabled( true ); 
serverModeChoiceList.addItemListener( 


// anonymous inner class to handle JComboBox events 
new ItemListener(){ 


// handle JComboBox event 
public void itemStateChanged( ItemEvent event ){ 
// determine whether check box selected 
if( event.getStateChange() == ItemEvent.SELECTED ){ 
serverSelection = serverModeChoiceList.getSelectedItem(); 
serverSelected = true; 
if( !retrieveFailedTransfers ){ 
retreiveA vailableFiles.setEnabled( true ); 


} 


controlPanelClient.setServerMode( serverSelection ); 


} 


} //end anonymous inner class 


); // end call to addItemListener 
add( serverModeChoiceList ); 


controlPanelClient.addPanel( this ); 


// constructs the Retreive files button 
retreiveAvailableFiles = new Button( "Retreive files.. " ); 
retreiveA vailableFiles.setFont( new Font( "Serif", Font.BOLD, 
PANEL_LABEL_FONT_SIZE ) ); 
retreiveA vailableFiles.setForeground( FONT_COLOR ); 
retreiveA vailableFiles.setBackground( BACKGROUND_COLOR ); 
retreiveAvailableFiles.addActionListener( new ActionListener() { 
public void actionPerformed( ActionEvent event ){ 
try{ 

serverAvailableFiles = controlPanelClient.getServerAvailableFiles(); 

retreiveA vailableFiles.setEnabled( false ); 

if( !serverAvailableFiles.isEmpty() ){ 

String[] fileList = new String[serverAvailableFiles.sizeQ) + 1]; 
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for( int 1 = 0; 1 < fileList.length; i++ ){ 


if(i==0 ){ 
fileList[i] = "Select file"; 
} else{ 
fileList[i] = ( String ) serverAvailableFiles.elementAtt i - 
1); 


} //end if else 


} //end for loop 
fileChoiceDialog = new FileSelectionDialog( controlPanelClient, 


controlPanelClient.getControlPanel(), 
fileChoiceLabel, 
fileList ); 
packetSizeChoiceList.setEnabled( true ); 
} else{ 
MessageDialog md = new MessageDialog( controlPanelClient, 
controlPanel, 
"* INFORMATION **", 
MESSAGE_DIALOG_TYPE, 
"No files availiable at server" ); 
} /end if else 
} catch( IOException ioe ){ 
MessageDialog md = new MessageDialog( controlPanelClient, 
controlPanel, 
"** ERROR **", 
MESSAGE_DIALOG_TYPE, 
"Fail to retreive file list" ); 


retreiveA vailableFiles.setEnabled( false ); 


} catch( ClassNotFoundException cnfe ){ 
MessageDialog md = new MessageDialog( controlPanelClient, 
controlPanel, 
"** ERROR **", 
MESSAGE_DIALOG_TYPE, 
"Unknown object received" ); 


} //end try catch block 
} //fend actionPerformed() method 
} /fend ActionListener class 


); /end addActionListener() method 


retreiveAvailableFiles.setEnabled( false ); 
add( retreiveAvailableFiles ); 


Label fileWhichSelected = new Label( "File selected :" ); 
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fileWhichSelected.setFont( new Font( "Serif", Font.BOLD, 13 ) ); 
fileWhichSelected.setForeground( FONT_COLOR ); 
add( fileWhichSelected ); 


fileChoiceLabel = new Label( "No file selected" ); 
fileChoiceLabel.setFont( new Font( "Serif", Font. BOLD, 
PANEL _ LABEL FONT_SIZE ) ); 
fileChoiceLabel.setBackground( BACKGROUND_COLOR ); 
fileChoiceLabel.setForeground( FONT_COLOR ); 


add( fileChoiceLabel ); 
controlPanelClient.addPanel( this ); 


packetSizeChoiceList = new java.awt.List( 4, false ); 

for( int i = 0; i < packetSizes.length; i++ ){ 
packetSizeChoiceList.add( packetSizes[i] ); 

} 

packetSizeChoiceList.setFont( new Font( "Serif", Font.BOLD, 

PANEL_LABEL_FONT_SIZE ) ); 

packetSizeChoiceList.setBackground( BACKGROUND_COLOR ); 

packetSizeChoiceList.setForeground( FONT_COLOR ); 

packetSizeChoiceList.setEnabled( true ); 

packetSizeChoiceList.addItemListener( 


// anonymous inner class to handle JComboBox events 
new ItemListener(){ 


// handle JComboBox event 
public void itemStateChanged( ItemEvent event ){ 
// determine whether check box selected 
if( event.getStateChange() == ItemEvent.SELECTED ){ 
packetSizeSelection = packetSizeChoiceList.getSelectedItem(); 
System.out.printIn( "packet size.. " + packetSizeSelection ); 
controlPanelClient.setPacketSize( new Integer( packetSizeSelection ). 
intValue() ); 
packetSizeSelected = true; 


} 
} 


} //end anonymous inner class 
); // end call to addItemListener 
packetSizeChoiceList.setEnabled( false ); 
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add( packetSizeChoiceList ); 


// constructs the download button 
askTheFile = new Button( "Download" ); 
askTheFile.setFont( new Font( "Serif", Font. BOLD, PANEL LABEL FONT_SIZE ) 


askTheFile.setForeground( FONT_COLOR ); 


askTheFile.setBackground( BACKGROUND_COLOR ); 
askTheFile.addActionListener( new ActionListener() { 
public void actionPerformed( ActionEvent event ){ 
if( fileSelected && serverSelected && packetSizeSelected ){ 

filesFromServer.setEnabled( false ); 
previousFailedFiles.setEnabled( false ); 
manualServerSelection.setEnabled( false ); 
predefinedServerSelection.setEnabled( false ); 
manualSelectServer.setEnabled( false ); 
selectServer.setEnabled( false ); 
serverModeChoiceList.setEnabled( false ); 
retreiveA vailableFiles.setEnabled( false ); 
packetSizeChoiceList.setEnabled( false ); 
askTheFile.setEnabled( false ); 
cancelTransfer.setEnabled( true ); 


controlPanelClient.setOffset( 0 ); 
fileSelection = fileChoiceLabel.getText(); 


if( !retrieveFailedTransfers ){ 
fileRequest = new PFTPFileRequest( FILE_REQUEST_TYPE, 
fileSelection, 
new String("" ), 0, 
new Integer( 
packetSizeSelection ). 
intValue() ); 
} else{ 
fileRequest = ( PFTPFileRequest ) 
oldPartialTransferRequests.elementAt( 
oldPartialTransfersFiles.indexOf( fileSelection ) ); 


} 


try{ 
controlPanelClient.setAskTheFile( true ); 
System.out.printIn( "Download pressed" ); 


} catch( Exception e ){ 
MessageDialog md = new MessageDialog( controlPanelClient, 
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controlPanel, 

"** RRROR **", 
MESSAGE_DIALOG_TYPE, 
"Problem in asking the file" ); 


} //end try catch block 


} else if( !fileSelected ){ 
if( serverSelected && packetSizeSelected ){ 
MessageDialog md = new MessageDialog( controlPanelClient, 
controlPanel, 
"=~ INFORMATION **", 
MESSAGE_DIALOG_TYPE, 
"Select server!" ); 


} else if( !serverSelected && !packetSizeSelected ){ 
MessageDialog md = new MessageDialog( controlPanelClient, 
controlPanel, 
"** INFORMATION **", 
MESSAGE_DIALOG_TYPE, 
"Select server,file,packet size!" ); 


} else if( !serverSelected ){ 
MessageDialog md = new MessageDialog( controlPanelClient, 
controlPanel, 
"* INFORMATION **", 
MESSAGE_DIALOG_TYPE, 
"Select file and server!" ); 


} else if( !packetSizeSelected ) { 
MessageDialog md = new MessageDialog( controlPanelClient, 
controlPanel, 
"** INFORMATION **", 
MESSAGE_DIALOG_TYPE, 
"Select file and packet size!" ); 


} /end if else if 
} else if( serverSelected && !packetSizeSelected ){ 
MessageDialog md = new MessageDialog( controlPanelClient, 
controlPanel, 
"* INFORMATION **", 
MESSAGE_DIALOG_TYPE, 
"Select packet size!" ); 


} else if( !serverSelected && packetSizeSelected ){ 
MessageDialog md = new MessageDialog( controlPanelClient, 
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controlPanel, 

"=k INFORMATION **", 
MESSAGE _DIALOG_TYPE, 
"Select server !" ); 


} else if( !serverSelected && !packetSizeSelected ){ 
MessageDialog md = new MessageDialog( controlPanelClient, 
controlPanel, 
"** INFORMATION **", 
MESSAGE_DIALOG_TYPE, 
"Select server and packet size!" ); 


} /end if else if 
} //fend actionPerformed() method 
} /fend ActionListener class 
); /end addActionListener() method 


add( askTheFile ); 


// constructs the cancel transfer button 
cancelTransfer = new Button( "Cancel Download" ); 
cancelTransfer.setFont( new Font( "Serif", Font.,BOLD, 
PANEL_LABEL_FONT_SIZE ) ); 
cancelTransfer.setForeground( FONT_COLOR ); 
cancelTransfer.setBackground( BACKGROUND_COLOR ); 
cancelTransfer.setEnabled( false ); 
cancelTransfer.addActionListener( new ActionListener() { 
public void actionPerformed( ActionEvent event ){ 
MessageDialog md = new MessageDialog( controlPanelClient, 
controlPanel, 
"ke WARNING **", 
YES_NO_DIALOG_TYPE, 
"Are you sure ?" ); 
if( messageOption == YES_OPTION ){ 
controlPanelClient.cancelFileTransfer(); 
imageProgressPanel.setVisible( false ); 
resetApplication(); 
messageOption = NO_OPTION; 
} /end if 


} //end actionPerformed() method 
} /fend ActionListener class 


); /end addActionListener() method 


add( cancelTransfer ); 
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setVisible( true ); 


} //fend constructor 


[** 

* Sets the fileSelected value 

k 

* @param state the the fileSelected boolean value 
wf 

public void setFileSelected( boolean state ){ 


fileSelected = state; 


} /fend setFileSelected() method 


[** 
* Resets the panel 
*/ 
public void reset() { 


filesFromServer.setEnabled( true ); 
filesFromServer.setState( true ); 
previousFailedFiles.setEnabled( true ); 
manualServerSelection.setEnabled( true ); 
predefinedServerSelection.setEnabled( true ); 
predefinedServerSelection.setState( true ); 
manualSelectServer.setEnabled( false ); 
selectServer.setEnabled( false ); 
serverModeChoiceList.setEnabled( true ); 
retreiveA vailableFiles.setEnabled( false ); 
packetSizeChoiceList.setEnabled( false ); 
askTheFile.setEnabled( true ); 
cancelTransfer.setEnabled( false ); 
fileSelected = false; 

serverSelected = false; 
packetSizeSelected = false; 
fileIsTransfering = false; 


} /fend reset() method 
} fend ControlPanel class 


[** 


* Provide a image progress panel to view the partial file transferred 
a 
private class ImageProgressPanel extends Dialog { 
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/** The The PFTPClient object assosiated with this panel */ 
private PFTPClientPPC imageProgressPanelClient; 


/** The image canvas */ 
private PFTPCanvas imageCanvas; 


/** The image canvas dimension */ 
private Dimension imageCanvasDimension; 


/** The updated times */ 
private int updatedTimes; 


/** The file name to preview */ 
private String fileNameToPreview; 


[** 


* Constructor 
ok 


* @param client the PFTPClient object assosiated with this panel 
ey. 
public ImageProgressPanel( PFTPClientPPC client ){ 
super( client, "0% of " + client.getFileNameToAsk() + 
"received!", false ); 
addWindowListener( new WindowListener() { 
public void windowOpened( WindowEvent event ){ 


} 


public void windowClosed( WindowEvent event ){ 
setVisible( false ); 


} 


public void windowClosing( WindowEvent event ){ 
setVisible( false ); 


} 


public void windowIconified( WindowEvent event ){ 


} 


public void windowDeiconified( WindowEvent event ){ 


} 


public void windowActivated( WindowEvent event ){ 


} 


public void windowDeactivated( WindowEvent event ){ 


} 
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})s 
imageProgressPanelClient = client; 


imageCanvas = new PFTPCanvas(); 
imageCanvasDimension = null; 
imageCanvas.setBackground( BACKGROUND_COLOR ); 


updatedTimes = 0; 
fileNameToPreview = null; 


setBackground( BACKGROUND_COLOR ); 
setSize( 240, 270 ); 
setLayout( new GridLayout( 1, 1 ) ); 
add( imageCanvas ); 
show(); 
} //fend constructor 


[** 


* Updates the iamage progress panel 

ES 

* @param fileBytes the file byte array to display 

a 
public void updateImageProgress( byte[] fileBytes ){ 


imageCanvasDimension = imageCanvas.getSize(); 
Image image = 
Toolkit.getDefaultToolkit().createImage( fileBytes ). 
getScaledInstance( 
-1, imageCanvasDimension.height, 
Image.SCALE_FAST ); 


imageCanvas.setImage( image ); 
imageCanvas.update( imageCanvas.getGraphics() ); 


} ///end updateImageProgress() method 


} //end ImageProgress class 


[*e* 

* The front dialog 

a 

private class FrontDialog extends Dialog { 


141 


/** The dialog client */ 
private PFTPClientPPC dialogClient; 


/** The dialog control panel */ 
private ControlPanel dialogControlPanel; 


/** The dialog text field */ 
private Label dialogTextField; 


/** The image canvas */ 
private PFTPCanvas imageCanvas; 


/** The image canvas dimension */ 
private Dimension imageCanvasDimension; 


/** The button to use the program */ 
private Button useltButton; 


[** 


* Constructor 
ok 


* @param client the PFTPClientPPC object assosiated with 
mf 
public FrontDialog( PFTPClientPPC client ){ 

super( client, "PFTP PocketPC Client 1.0", true ); 


addWindowListener( new WindowListener() { 
public void windowOpened( WindowEvent event ){ 


} 


public void windowClosed( WindowEvent event ){ 
setVisible( false ); 
System.exit( 0 ); 

} 


public void windowClosing( WindowEvent event ){ 
setVisible( false ); 
System.exit( 0 ); 

} 


public void windowIconified( WindowEvent event ){ 


} 


public void windowDeiconified( WindowEvent event ){ 


} 
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public void windowActivated( WindowEvent event ){ 


} 


public void windowDeactivated( WindowEvent event ){ 


} 
})s 


dialogClient = client; 

dialogTextField = new Label("" ); 
setBackground( BACKGROUND_COLOR ); 
setSize( 240, 300 ); 


setLayout( new BorderLayout() ); 
dialogTextField.setBackground( BACKGROUND_COLOR ); 
add( dialogTextField, BorderLayout.NORTH ); 


imageCanvas = new PFTPCanvas(); 
imageCanvas.setBackground( BACKGROUND_COLOR ); 


byte[] imageBytes = new byte[1]; 

try 
File file = new File( "pftpLogoClient.gif" ); 
FileInputStream fis = new FileInputStream( file ); 
imageBytes = new byte[( int ) file.lengthQ]; 
fis.read( imageBytes ); 

} catch( IOException ioe ){ 
System.out.printIn( "No logo to show!" ); 

} 

Image image; 

image = Toolkit.getDefaultToolkit().createlmage( imageBytes ); 

imageCanvas.setImage( image ); 


add( imageCanvas, BorderLayout.CENTER ); 


// constructs the use it button 

uselItButton = new Button( "Use it!" ); 
useltButton.setFont( new Font( "Serif", Font. BOLD, 20 ) ); 
useltButton.setForeground( FONT_COLOR ); 


useltButton.setBackground( BACKGROUND_COLOR ); 
uselItButton.addActionListener( new ActionListener() { 
public void actionPerformed( ActionEvent event ){ 
setVisible( false ); 
} //end actionPerformed() method 
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} /fend ActionListener class 
); /end addActionListener() method 


add( useltButton, BorderLayout.SOUTH ); 


show(); 
} //fend constructor 


} /fend FrontDialog class 


[** 

* A file selction dialog 

*] 

private class FileSelectionDialog extends Dialog { 


/** The dialog client */ 
private PFTPClientPPC dialogClient; 


/** The dialog control panel */ 
private ControlPanel dialogControlPanel; 


/** The dialog text field */ 
private Label dialogTextField; 


/** The item list */ 
private String[] itemList; 


/** The dialog combo box */ 
private java.awt.List dialogComboBox; 


/** dialog button */ 
private Button dialogButton; 


/** The dialog selection */ 
private String dialogSelection; 


[** 
* Constructor 
ES 
* @param client the PFTPClientPPC object assosiated with 
* @param panel the ControlPanel object assosiated with 
* @param fileField the text field 
* @param list the file list 
ss 
public FileSelectionDialog( PFTPClientPPC client, 
ControlPanel panel, 
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Label fileField, 
String[] list 
nt 


super( client, "Choose a file to transfer", true ); 


addWindowListener( new WindowListener() { 
public void windowOpened( WindowE vent event ){ 


} 


public void windowClosed( WindowEvent event ){ 
setVisible( false ); 


} 


public void windowClosing( WindowEvent event ){ 
setVisible( false ); 


} 


public void windowIconified( WindowEvent event ){ 


} 


public void windowDeiconified( WindowEvent event ){ 


} 


public void windowActivated( WindowEvent event ){ 


} 


public void windowDeactivated( WindowEvent event ){ 


} 
})s 


dialogClient = client; 

dialogControlPanel = panel; 

dialogTextField = fileField; 

itemList = list; 

dialogSelection = null; 

setBackground( BACKGROUND_COLOR ); 
setSize( 240, 200 ); 

this.setLocation( 0, 20 ); 

setLayout( new GridLayout( 5, 1 ) ); 


// just to fill the empty cell 
add( new Panel() ); 


dialogComboBox = new java.awt.List( 4, false ); 
for( int k = 0; k < itemList.length; k++ ){ 
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dialogComboBox.add( itemList[k] ); 
} 
dialogComboBox.setFont( new Font( "Serif", Font. BOLD, 

PANEL_LABEL_FONT_SIZE ) ); 

dialogComboBox.setBackground( BACKGROUND_COLOR ); 
dialogComboBox.setForeground( FONT_COLOR ); 
dialogComboBox.setEnabled( true ); 
dialogComboBox.addItemListener( 


// anonymous inner class to handle JComboBox events 
new ItemListener(){ 


// handle JComboBox event 
public void itemStateChanged( ItemEvent event ){ 
// determine whether check box selected 
if( event.getStateChange() == ItemEvent.SELECTED ){ 
dialogSelection = itemList[dialogComboBox. 
getSelectedIndex()]; 
} 


} 
} //end anonymous inner class 
); / end call to addItemListener 
add( dialogComboBox ); 
add( new Panel() ); 


Panel buttonPanel = new Panel(); 
buttonPanel.setLayout( new GridLayout( 1, 3 ) ); 


// constructs the ok button 

dialogButton = new Button( "OK" ); 

dialogButton.setFont( new Font( "Serif", 
PANEL_LABEL_FONT_SIZE ) ); 

dialogButton.setForeground( FONT_COLOR ); 


dialogButton.setBackground( BACKGROUND_COLOR ); 
dialogButton.addActionListener( new ActionListener(){ 
public void actionPerformed( ActionEvent event ){ 
dialogTextField.setText( dialogSelection ); 
dialogControlPanel.setFileSelected( true ); 
setVisible( false ); 
} //end actionPerformed() method 


146 


Font.BOLD, 


} /fend ActionListener class 
); /end addActionListener() method 


buttonPanel.add( new Panel() ); 
buttonPanel.add( dialogButton ); 
buttonPanel.add( new Panel() ); 
add( buttonPanel ); 

add( new Panel() ); 


show(); 
} //fend constructor 


} //end FlileSelectionDialog class 


[** 

* A Message dialog 

oy 

public class MessageDialog extends Dialog { 


/** The dialog client */ 
private PFTPClientPPC dialogClient; 


/** The dialog title */ 
private String dialogTitle; 


/** The dialog text field */ 
private Label dialogTextField; 


/** The dialog button */ 
private Button dialogButton; 


/** The message type */ 
private int messageType; 


/** The dialog message */ 
private String dialogMessage; 


[** 


* Constructor 
ok 


* @param client the PFTPClientPPC object assosiated with 
* @param panel the ControlPanel object assosiated with 
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* @param title the dialog title 

* @param type the dialog type 

* @param message the dialog message 

a 

public MessageDialog( PFTPClientPPC client, 

ControlPanel panel, 
String title, 
int type, 
String message 


nt 


super( client, title, true ); 


dialogClient = client; 

messageType = type; 

dialogMessage = message; 

dialogTextField = new Label( dialogMessage ); 
dialogTextField.setFont( new Font( "Serif", Font.BOLD, 13 ) ); 
dialogTextField.setForeground( FONT_COLOR ); 
setBackground( BACKGROUND_COLOR ); 

setSize( 240, 120 ); 

setLocation( 0, 80 ); 

setLayout( new GridLayoutt( 3, 1 ) ); 


addWindowListener( new WindowListener() { 
public void windowOpened( WindowE vent event ){ 


} 


public void windowClosed( WindowEvent event ){ 
setVisible( false ); 


} 


public void windowClosing( WindowEvent event ){ 
setVisible( false ); 


} 


public void windowIconified( WindowEvent event ){ 


} 


public void windowDeiconified( WindowEvent event ){ 


} 


public void windowActivated( WindowEvent event ){ 


} 


public void windowDeactivated( WindowEvent event ){ 


} 
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}); 
add( dialogTextField ); 
add( new Panel() ); 


Panel buttonPanel = new Panel(); 

buttonPanel.setBackground( BACKGROUND_COLOR ); 

if( messageType == MESSAGE_DIALOG_TYPE ){ 
buttonPanel.setLayout( new GridLayout( 1, 1 ) ); 


buttonPanel.add( new Panel() ); 


// constructs the ok button 

dialogButton = new Button( "OK" ); 

dialogButton.setFont( new Font( "Serif", Font.BOLD, 
PANEL_LABEL_FONT_SIZE ) ); 

dialogButton.setForeground( FONT_COLOR ); 


dialogButton.setBackground( BACKGROUND_COLOR ); 
dialogButton.addActionListener( new ActionListener(){ 
public void actionPerformed( ActionEvent event ){ 
setVisible( false ); 
} //end actionPerformed() method 
} //end ActionListener class 
); /end addActionListener() method 


buttonPanel.add( dialogButton ); 
buttonPanel.add( new Panel() ); 


} else if( messageType == YES_NO_DIALOG_TYPE ){ 
buttonPanel.setLayout( new GridLayout( 1, 4 ) ); 


buttonPanel.add( new Panel() ); 

// constructs the yes button 

Button yesButton = new Button( "YES" ); 

yesButton.setFont( new Font( "Serif", Font.BOLD, PANEL_LABEL_FONT_SIZE ) 
yesButton.setForeground( FONT_COLOR ); 

yesButton.setBackground( BACKGROUND_COLOR ); 
yesButton.addActionListener( new ActionListener() { 


public void actionPerformed( ActionEvent event ){ 
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dialogClient.cancelFileTransfer(); 
imageProgressPanel.setVisible( false ); 
resetApplication(); 
setVisible( false ); 
} //fend actionPerformed() method 
} /fend ActionListener class 
); /end addActionListener() method 
buttonPanel.add( yesButton ); 


// constructs the no button 
Button noButton = new Button( "NO" ); 
noButton.setFont( new Font( "Serif", Font. BOLD, PANEL LABEL FONT_SIZE ) 


noButton.setForeground( FONT_COLOR ); 
noButton.setBackground( BACKGROUND_COLOR ); 
noButton.addActionListener( new ActionListener() { 
public void actionPerformed( ActionEvent event ){ 
setVisible( false ); 
} //fend actionPerformed() method 
} //end ActionListener class 
); /end addActionListener() method 
buttonPanel.add( noButton ); 
buttonPanel.add( new Panel() ); 
} else{ 
} /end if else if 
add( buttonPanel ); 
showQ(); 
} //fend constructor 


} //end MessageDialog class 
} //fend PFTPClientPPC class 
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//packages for network componets 
import java.io.*; 
import java.net.*; 


//packages for user interface components 
import java.awt.*; 

import java.awt.event.*; 

import java.util.*; 

import javax.swing.*; 

import javax.swing.text.*; 


//package for security components 
import java.security.*; 


//package for charecter encoding components 
import sun.misc.*; 


[** 
* File PPFTPServer.java 
* 


* This is the PFTP Application Server 

* 

* This server is waiting for clients to connect on port and it supports 
* only file tranfer commands sit gets a file transfer command, it checks if the file 
* version exists looking at its hash valuesends a message 

* about how many bytes is the file and then send them one byte at the 
* time. To make the file look big, I placed a pause() during the each 

* byte transfer. 

* To manage the lost connection and keep track of the file tranfer 

* progress each of them, I used a data stucture to store them 

* 

* @author LT Periklis Pantoleon 

* @version 1.0 

oy 
public class PFTPServer extends JFrame { 


// 


/** The default port the FTP server is waiting for clients */ 
private static final int DEFAULT_PORT = 6789; 
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/** The timeout period for the sockets */ 
private static final int SO_TIME_OUT = 3000; 


/** The length in bytes of the file hash value */ 
private static final int MD5_HASH_LENGTH = 16; 


/** The key for the hashing computation*/ 
private static final byte[] HASH_KEY = ( new String( "Periklis” ) ).getBytes(); 


/** The font size for the panels' titles */ 
private static final int PANEL_TITLE_FONT_SIZE = 17; 


/** The font size for the panels' labels */ 
private static final int PANEL_LABEL_FONT_SIZE = 13; 


/** The option to add a file to file database */ 
private static final int ADD_FILE_OPTION = 1; 


/** The option to remove a file to file database */ 
private static final int REMOVE_FILE_OPTION = 2; 


/** The request type when a file is asked */ 
private static final int FILE_REQUEST_TYPE = 1; 


/** The request type when a file array is asked */ 
private static final int FILE_ARRAY_REQUEST_TYPE = 0; 


/** The panels' font color */ 
private static final Color FONT_COLOR = Color.white; 


/** The color of the backgroung of the frames and panels */ 
private static final Color BACKGROUND_COLOR = new Color( 77, 92 , 240 ); 


/** The color of the panels’ border */ 
private static final Color PANEL_BORDER_COLOR = Color.blue; 


/** The file name of the logo image of the server frame */ 
private static final String LOGO_IMAGE = "pftpLogoServer.gif"; 


/** The server socket */ 
private ServerSocket serverSocket; 


/** The socket that is assigned to the client */ 
private Socket mainSocket; 


/** The file input stream */ 
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private FileInputStream fis; 


/** The map that store the file available for transfer */ 
private AvailableFileMap fileMap; 


/** The list of file names in the file map */ 
private ArrayList fileNamesInMap; 


/** The boolean value that indicates the listening status of the server */ 
private boolean startListening; 


/** The boolean value that indicates if user want to exit the application */ 
private boolean exitApplication; 


/** The number of current server clients */ 
private int numberOfCurrentClients; 


/** The number of total file transfers tries */ 
private int numberOfTotalTransfers; 


/** The number of failed file transfers */ 
private int numberOfTransferFailures; 


/** The percentage of failed file transfers */ 
private double percentageOfTransferFailures; 


/** The number of files in the server file database */ 
private int numberOfLocalFiles; 


// 
/** The panel that shows the server status */ 
private PFTPServerStatusPanel statusPanel; 


/** The front label shown before starting the server */ 
private JLabel startFrontLabel; 


/** The menu item to start the server */ 
private JMenultem startServerltem; 


/** The menu item to stop the server */ 
private JMenultem stopServerltem; 
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/** The menu item to add a file to server's database */ 
private JMenultem addFileItem; 


/** The menu item to remove a file from server's database */ 
private JMenultem removeFileltem; 


/** The frame used to delete a file from server's database */ 
private JFrame deleteFileFrame; 


// 


[** 


* Default constructor 
*/ 
public PFTPServer() { 


super( "PFTPServer" ); 

statusPanel = new PFTPServerStatusPanel( this ); 
fileMap = new AvailableFileMap(); 

// set up Server menu and its menu items 

JMenu fileMenu = new JMenu( "Server" ); 


fileMenu.setMnemonic( 'S' ); 


// set up start server item 
startServerltem = new JMenultem( "Start server" ); 


startServerltem.addActionListener( 


// anonymous inner class to handle menu item event 
new ActionListener(){ 


public void actionPerformed( ActionEvent event ){ 


if( fileMap.isEmpty() ){ 
JOptionPane.showMessageDialog( null, 
"You must add files to server database \n" + 
" before you start the server!!", 
"Can't start", 
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JOptionPane.[NFORMATION_MESSAGE ); 
} else{ 
try{ 
// Creates a server socket with the defaut port 
serverSocket = new ServerSocket( DEFAULT_PORT ); 
startServerltem.setEnabled( false ); 
stopServerltem.setEnabled( true ); 
startListening = true; 
startFrontLabel.setVisible( false ); 
statusPanel.setVisible( true ); 
getContentPane().add( statusPanel, BorderLayout.CENTER ); 
} catch( IOException ioe ){ 
JOptionPane.showMessageDialog( null, ioe, 
"Problem starting the server", 
JOptionPane.ERROR_MESSAGE ); 
} //end try catch block 
} /end if else 


} //fend actionPerformed() method 
} //end anonymous inner class 
); // end call to addActionListener 
fileMenu.add( startServerlItem ); 


// set up stop server item 

stopServerltem = new JMenultem( "Stop server" ); 
stopServerltem.setEnabled( false ); 
stopServerltem.addActionListener( 


// anonymous inner class to handle menu item event 
new ActionListener() { 


public void actionPerformed( ActionEvent event ){ 


stopServerltem.setEnabled( false ); 
startServerltem.setEnabled(true); 
startListening = false; 
startFrontLabel.setVisible( true ); 
statusPanel.setVisible( false ); 
try 
System.out.printin("Server stopped!"); 
serverSocket.close(); 
}catch IOException ioe) { 
JOptionPane.showMessageDialog( null, ioe, 
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"Server can not stop, you can exit ", 
JOptionPane.ERROR_MESSAGE ); 
}//end try catch block 


} //fend actionPerformed() method 
} //end anonymous inner class 
); // end call to addActionListener 
fileMenu.add( stopServerltem ); 


// set up Exit menu item 
JMenultem exitItem = new JMenultem( "Exit" ); 


exitItem.addActionListener( 


// anonymous inner class to handle exitItem event 
new ActionListener() { 


// terminate application if user select the exit item 
public void actionPerformed( ActionEvent event ){ 


if( JOptionPane.showConfirmDialog( null, 
"Are you sure you want to exit the application?", 
null, 
JOptionPane. YES_NO_OPTION ) == 


JOptionPane.OK_OPTION ){ 
JOptionPane.showMessageDialog( null, "Thank you for using PFTPServer", 
"PFTPServer", 
JOptionPane. INFORMATION_MESSAGE ); 


exitApplication = true; 
System.exit( 0 ); 
} //end if 
} //end actionPerformed() method 
} //end anonymous inner class 
); // end addActionListener 
fileMenu.add( exitItem ); 


// create menu bar and attach it to the server's frame 
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JMenuBar bar = new JMenuBar(); 
setJMenuBar( bar ); 


bar.add( fileMenu ); 


// set up Database menu and its menu items 
JMenu databaseMenu = new JMenu( "Database" ); 
fileMenu.setMnemonic( 'D' ); 


// set up add file menu item 
addFileItem = new JMenultem( "Add file to database" ); 


addFileItem.addActionListener( 


// anonymous inner class to handle menu item event 
new ActionListener() { 


//check if the file extension is a valid one and add 
//the file to server's database 
public void actionPerformed( ActionEvent event ){ 


File file = selectFile) ADD_FILE_OPTION ); 
if( file.equals( null ) ){ 
JOptionPane.showMessageDialog( null, "No file added", 
"PFTPServer", 
JOptionPane. INFORMATION_MESSAGE ); 
} else if( !file.getName().endsWith( ".gif" ) && 
!file.getName().ends With( ".GIF" ) && 
!file.getName().endsWith( ".png" ) && 
!file.getName().endsWith( ".PNG" ) && 
!file.getName().endsWith( "jpeg" ) && 
!file.getName().endsWith( "jpeg" ) ){ 
JOptionPane.showMessageDialog( null, "No file added \n" + 
"Please select only .gif, .png or .jpeg files", 
"PFTPServer", 
JOptionPane. INFORMATION_MESSAGE ); 


} else { 


boolean fileExists = fileMap.hasFile(file.getName()); 

int userOption = JOptionPane. YES_OPTION; 

if (fileExists) { 

userOption = JOptionPane.showOptionDialog(null, " The file already exists!.\n"+ 
"Do you want to overwrite it?", "File exists!", JOptionPane. YES_NO_OPTION, 
JOptionPane. INFORMATION_MESSAGE, null, null, null); 

felse{ 
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//numberOfLocalFiles++; 
}//end if 


if (userOption == JOptionPane. YES_OPTION){ 
try{ 


FileInputStream fis = new FileInputStream( file ); 

byte[] fileBytes = new byte[( int ) file length(]; 

//read the bytes from the file 

fis.read( fileBytes ); 

if (fileExists) { 
fileMap.removeFile(file.getName()); 
fileNamesInMap.remove(file.getName()); 


} 

fileMap.addFile( file.getName(), fileBytes ); 
fileNamesInMap.add( file.getName() ); 
fis.close(); 

numberOfLocalFiles++; 


} catch( IOException ioe ){ 
JOptionPane.showMessageDialog( null, "No file added \n" + 
"Problem reading the file!", 
"Error", 
JOptionPane.ERROR_MESSAGE ); 
} //end try catch block 
}/end if 
} /end if else if block 
statusPanel.updateServerStatus(); 
} //end actionPerformed() method 
} // end anonymous inner class 


); // end call to addActionListener 
databaseMenu.add( addFilelItem ); 


// set up remove file menu item 
removeFileItem = new JMenultem( "Remove a file from database" ); 


removeFileItem.addActionListener( 


// anonymous inner class to handle menu item event 
new ActionListener(){ 


// if the file database is not empty it removes the file selected 
public void actionPerformed( ActionEvent event ){ 


158 


if( fileMap.isEmpty() ){ 

JOptionPane.showMessageDialog( null, "No file available in database", 
"PFTPServer", 

JOptionPane. INFORMATION_MESSAGE ); 


} else{ 


String[] fileList = new String[fileNamesInMap.size() + 1]; 
for( int i = 0; i < fileList.length; i++ ){ 
if(i == 0 ){ 
fileList[i] = "Select file to delete"; 
} else{ 
fileList[i] = ( String ) fileNamesInMap.get( i - 1 ); 
} /fend if else 
} //end for loop 


deleteFileFrame = new DeleteFileFrame( fileList ); 


} /fend if else 
statusPanel.updateServerStatus(); 
} //fend actionPerformed() method 


} //end anonymous inner class 
); // end call to addActionListener 


// create a menu item and attach it to menu bar 
databaseMenu.add( removeFilelItem ); 
bar.add( databaseMenu ); 


//create the front label of the main frame 

startFrontLabel = new JLabel( new ImageIcon( LOGO_IMAGE ) ); 
getContentPane().setBackground( BACKGROUND_COLOR ); 
getContentPane().add( startFrontLabel, BorderLayout.CENTER ); 


setSize( 350, 200 ); 


setLocation( 300, 250 ); 
setVisible( true ); 
setDefaultCloseOperation( JFrame.EXIT_ON_CLOSE ); 


//intialize the main variables 
startListening = false; 
exitApplication = false; 

fileMap = new AvailableFileMap(); 
fileNamesInMap = new ArrayListQ); 
numberOfCurrentClients = 0; 
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numberOfTotalTransfers = 0; 
numberOfTransferFailures = 0; 
percentageOfTransferFailures = 0; 
numberOfLocalFiles = 0; 


//update the server status 
statusPanel.updateServerStatus(); 


} // end default constructor 


[** 
* Sets the number of current clients 
k 
* @param currentClients number of current clients 
td 
public void setNumberOfCurrentClients( int currentClients ){ 
numberOfCurrentClients = currentClients; 
} /fend setNumberOfCurrentClients() method 


[i 
* Sets the number of total file transfers 
ok 
* @param totalTransfers the number of total file transfers 
=] 
public void setNumberOfTotalTransfers( int totalTransfers ) { 
numberOfTotalTransfers = totalTransfers; 
} /fend setNumberOfTotalTransfers() method 


[** 

* Sets the number of failed file transfers 

ok 

* @param totalFailures the number of failed file transfers 

*/ 
public void setNumberOfTransferFailures( int totalFailures ){ 

numberOfTransferFailures = totalFailures; 

} //fend setNumberOfTransferFailures() method 


[** 


* Sets the percentage of failed transfers 
* 


* @param failurePercentage the percentage of failed transfers 

zo 

public void setPercentageOfTransferFailures( double failurePercentage ){ 
percentageOfTransferFailures = failurePercentage; 

} //end setPacketSize() method 
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[** 
* Sets the number of local files in server's database 
BS 


* @param localFiles the number of local files in server's database 
ad 

public void setNumberOfLocalFiles( int localFiles ){ 
numberOfLocalFiles = localFiles; 

} /fend setNumberOfLocalFiles() method 


[** 
* Returns the number of current clients 
ok 


* @return the number of current clients 
id 
public synchronized int getNumberOfCurrentClients() { 
notify(); 
return numberOfCurrentClients; 
} //end getNumberOfCurrentClients() method 


[** 
* Returns the number of total file transfers 
ok 


* @return the number of total file transfers 
*] 
public synchronized int getNumberOfTotalTransfers() { 
notify(; 
return numberOfTotalTransfers; 
} //end getNumberOfTotalTransfers() method 


[** 
* Returns the number of failed file transfers 
ok 


* @return the number of failed file transfers 

*} 

public synchronized int getNumberOfTransferFailures() { 
notify; 
return numberOfTransferFailures; 

} //fend getNumberOfTransferFailures() method 


[** 


* Returns the percentage of failed transfers 
* 


* @return the percentage of failed transfers 

i 

public synchronized double getPercentageOfTransferFailures() { 
notify; 
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if( getNumberOfTotalTransfers() != 0 ){ 
setPercentageOfTransferFailures( 
( double ) ( getNumberOfTransferFailures() / 
getNumberOfTotalTransfers() ) * 
100 ); 
} else{ 
setPercentageOfTransferFailures( 0 ); 
} /end if else 
return percentageOfTransferFailures; 
} //end getPercentageOfTransferFailures() method 


[** 
* Returns the number of local files in server's database 
* 
* @return the number of local files in server's database 
*/ 
public synchronized int getNumberOfLocalFiles() { 
notify(); 
return numberOfLocalFiles; 
} //end getNumberOfLocalFiles() method 


[** 

* Adds a panel to a container 

* 

* @param container the container to add the panel 

sa 

public void addPanel( Container container ){ 
JPanel dummy = new JPanel(); 
dummy.setBackground( BACKGROUND_COLOR ); 
container.add( dummy ); 

} //fend addPanel() method 


[** 
* Removes a file from server's database 
* 
* @param fileForDeletion the string file name to delete from database 
oh 
public void removeFromDatabase( String fileForDeletion ){ 
if( !fileForDeletion.equals( null ) ){ 
fileMap.removeFile( fileForDeletion ); 
fileNamesInMap.remove( fileForDeletion ); 
numberOfLocalFiles--; 
JOptionPane.showMessageDialog( null, 
"File " + fileForDeletion + " deleted!", 
"PFTPServer", 
JOptionPane INFORMATION_MESSAGE ); 
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} else{ 
JOptionPane.showMessageDialog( null, "No file deleted!", 
"PFTPServer", 
JOptionPane. INFORMATION_MESSAGE ); 
} /end if else 
} /fend removeFromDatabase() method 


[** 
* Returns the file that selected by the user to be added or removed 
* 
* @return the file that selected by the user to be added or removed 
* @param addOrRemoveOption the integer option for add or remove 
| 
private File selectFile( int addOrRemoveOption ){ 
File selectedFileName = null; 
try{ 
// display file dialog so user can select file 
JFileChooser fileChooser = new JFileChooser(); 
fileChooser.setFileSelectionMode( 
JFileChooser.FILES_ONLY ); 


int result; 


if( addOrRemoveOption == ADD_FILE_OPTION ){ 
result = fileChooser.showDialog( this, "Add" ); 

} else{ 
result = fileChooser.showDialog( this, "Remove" ); 


} 


// if user clicked Cancel button on dialog, return 
if( result == JFileChooser.CANCEL_OPTION ){ 
return null; 
} else if( result == JFileChooser. APPROVE_OPTION ){ 


// obtain selected file 
selectedFileName = fileChooser.getSelectedFile(); 


} /end if else if 
} catch( NullPointerException npe ){ 


} //end try catch block 
return selectedFileName; 
} // end selectFile() method 
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[** 
* Delays the current thread by certain amount of milliseconds 
* 
* @param msec the milliseconds to delay the execution 
sa 
public void delay( int msec ){ 
try{ 
Thread.sleep( msec ); 
} catch( InterruptedException ie ){ 
System.out.printIn( "Thead sleep interupted" ); 
} // end try catch block 
} // end delay() method 


[** 
* Manage the starting and stoping of the server side 
za 
public void startListening() { 
while( !exitApplication ){ 
delay( 50 ); 


if( startListening ){ 
System.out.printIn( "Server started!" ); 
try{ 
while( startListening ){ 
mainSocket = serverSocket.accept(); 
ClientHandler newClientHandler = new ClientHandler( mainSocket ); 
System.out.printIn( "New connection established" ); 
statusPanel.updateServerStatus(); 
Thread newConnection = new Thread( newClientHandler ); 
newConnection.start(); 
if( !startListening ){ 
startServerltem.setEnabled( true ); 


} 
} //end while loop 


} catch( IOException ioe ){ 
if( startListening ){ 
JOptionPane.showMessageDialog( null, ioe, 
"Server can not start listening " + 
"in port " + DEFAULT_PORT, 
JOptionPane.ERROR_MESSAGE ); 
}//end if 
} //end try catch block 
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} else if (serverSocket != null && !serverSocket.isClosed()){ 


}/ end if else 
} //end outer whole loop 
System.exit( 0 ); 
} //end startListening method 


[** 


* Main method to start 
ok 


* @param args argument list 

* @throws Exception 

*/ 

public static void main( String args[] ){ 
//Mnitialiaze the server application 
PFTPServer theFTPServer = new PFTPServer(); 
//start listening at default port 
theFTPServer.startListening(); 


} //fend main method 


// 


[** 

* Handles the connection and the file transfer with each client 
*/ 
private class ClientHandler implements Runnable { 


/** The socket to comunicate with the client */ 
private Socket clientSocket; 


/** The object input stream to receive objects from client */ 
private ObjectInputStream inObjectFromClient; 


/** The object output stream to send objects to client */ 
private ObjectOutputStream outObjectToClient; 


/** The file request received from client */ 
private PFTPFileRequest request; 


/** The vector of the files available in the server database */ 
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private Vector filesAvailable; 


/** The request type */ 
private int requestT ype; 


/** The requested file name */ 
private String fileName; 


/** The hash value of the requested file */ 
private String fileHash; 


/** The packet size */ 
private int packetSize; 


/** The offset value in the file request */ 
private int offset; 


/** The length of the requested file in bytes */ 
private int numOfBytes; 


[** 

* Constructor 

ES 

* @param aSocket the socket to communicate with the client 
* @throws SocketException 

*f 

public ClientHandler( Socket aSocket ) throws SocketException { 
// Initialize the socket to client 
clientSocket = aSocket; 
// Sets the timout period of the socket 
clientSocket.setSoTimeout(SO_TIME_ OUT); 

} //end constructor 


[** 
* The run() method of the Runnable ClientHandler class that 
* handles the connection to the client 
*/ 

public void run(){ 


setNumberOfCurrentClients( getNumberOfCurrentClients() + 1 ); 
System.out.println("Clients: " + getNumberOfCurrentClients() ); 
statusPanel.updateServerStatus(); 

// Opens the streams for communicating with the client 
openStreams(); 

// Handles the file transfer 

handleFileRequest(); 
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// Closes the connection when done 

closeConnection(); 

// Reduce the number of clients connected 
setNumberOfCurrentClients( getNumberOfCurrentClients() - 1 ); 
System.out.printIn("Clients: " + getNumberOfCurrentClients() ); 
statusPanel.updateServerStatus(); 


} // end of run(Q) method 


[** 


* Opens the streams for communicating with the client 
ay 
private void openStreams() { 


try{ 


outObjectToClient = new ObjectOutputStream( 
clientSocket.getOutputStream() ); 


inObjectFromClient = new ObjectInputStream( 
clientSocket.getInputStream() ); 


} catch( IOException ioe ){ 


System.out.printIn( "Server: Failed to open I/O streams\n" + ioe ); 
System.exit( 1 ); 


} // end try catch block 
} // end openStreams() method 


[** 

* Handles the file request of the client 
| 
private void handleFileRequest() { 


try{ 


System.out.printIn( "New client connected!!" ); 
request = ( PFTPFileRequest ) inObjectFromClient.readObject(); 
requestT ype = request.getRequestType(); 


if( requestType == FILE_LARRAY_REQUEST_TYPE )f{ 
filesAvailable = new Vector(); 
for( int k = 0; k < fileNamesInMap.sizeQ); k++ ){ 
filesAvailable.add( fileNamesInMap.get( k ) ); 
} //end for loop 
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outObjectToClient.writeObject( filesAvailable ); 
outObjectToClient.flushQ; 

} else if( requestl ype == FILE_REQUEST_TYPE ){ 
clientSocket.setSoTimeout( SO_TIME_ OUT ); 
fileName = request.getFile(); 
fileHash = request.getHash(); 
offset = request.getOffset(); 
packetSize = request.getPacketSize(); 


System.out.printIn( "Received request packet -> ... File name: " + 


fileName + 

"\n File hash: "+ 
fileHash + 

"\n Offset: "+ 
offset + 

"\n Packet size: "+ 


packetSize ); 


if( offset == 0 ){ 

fileHash = getHashValue( fileName ); 

if( fileHash.equals( new String( "fileNotFound" ) ) ){ 
System.out.printIn( "File " + fileName + " not found!" ); 
outObjectToClient.write UTF( fileHash ); 
outObjectToClient.flushQ; 

} else if( fileHash.equals( new String( "hashProblem" ) ) ){ 
System.out.printIn( "Problem in hashing file " + fileName ); 
outObjectToClient.writeUTF( fileHash ); 
outObjectToClient.flush(); 

} else{ 

System.out.printIn( "File found!" ); 


outObjectToClient.writeUTF( fileHash ); 
outObjectToClient.flush(); 
System.out.printIn( "Hash " + fileHash + " is send, length " + 
fileHash.lengthQ ); 
System.out.println( "Sending the file...." ); 
sendFile( fileName, packetSize, offset ); 
} /end if else if 
} else{ 
try{ 
if( checkHash( fileName, fileHash ) ){ 
System.out.printIn( "Sending the file..." ); 
outObjectToClient.writeUTF( "Start sending" ); 
sendFile( fileName, packetSize, offset ); 
} else{ 
outObjectToClient.writeUTF( "fileNotMatch" ); 
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} /end if else 
} catch( IOException ioe ){ 
System.out.printIn( "Problem in sending the file!" ); 
setNumberOfTransferFailures( getNumberOfTransferFailures() + 1 ); 
statusPanel.updateServerStatus(); 
System.out.printin( ioe ); 
} // end try catch block 
} // end if else block 
} else{ 
outObjectToClient.writeUTF( "noValidRequest" ); 
outObjectToClient.flush(); 
} /end if else if 
} catch( Exception e ){ 
System.out.printin( e ); 
} 
} //end HandleFileRequest() method 


[** 
* Closes the socket connection 
af 
private void closeConnection() { 
try{ 
clientSocket.close(); 
} catch( IOException ioe ){ 
} //end try catch block 
} fend closeConnection() method 


[** 
* Compute the hash value of a given file 
* 
* @param fileName the name of the file 
* @return the String representation of the file hash value 
| 
public String getHashValue( String fileName ){ 


String theHash = null; 
try 
File theFile = new File( fileName ); 
fis = new FileInputStream( theFile ); 
byte[] buffer = new byte[8192]; 
int length; 
//Select the MDS hash algorithm 
MessageDigest md = MessageDigest.getInstance( "MD5" ); 
while( ( length = fis.read( buffer ) ) != -1 ){ 
md.update( buffer, 0, length ); 
} 
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fis.close(); // Close the file stream to free the file 


// Final computation of the hash 
byte[] hash = md.digestQ); 


// Create a String version of the hash value using the default 
// 64bit Character encoding algorithm. 

BASE64Encoder encoder = new BASE64Encoder(); 
theHash = encoder.encode( hash ); 


} catch( FileNotFoundException fnfe ){ // In case file not found 
System.out.printIn( fnfe ); 
theHash = new String( "fileNotFound" ); 

} catch( Exception e ){ // In case there is problem 
System.out.println( e ); // with hash computation 
theHash = new String( "hashProblem" ); 

} 


return theHash; 


} //end getHashValue() method 


[** 
* Checks if a file is asked have the given hash value 
* 
* @param file the name of the file 
* @param hashValueToCheck the hash value to check the validity 
* @return true if hashes match and false if they don't 
| 
public boolean checkHash( String file, String hashValueToCheck ){ 
boolean check; 
String existedHash = getHashValue( file ); 
if( existedHash.equals( hashValueToCheck ) ){ //check the two hashes 
check = true; 
} else{ 
check = false; 
} /lend if else 


return check; 


}//end checkHash() method 


[** 


* Sends the file to client with the asked packet size and offset 
* 


* @param nameOfFile the name of the file 
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* @param packetSize the hash value to check the validity 
* @param offset the offset from where client wants the file 
* @throws IOException if something goes wrong with the stream use 
* @throws FileNotFoundException if the file asked doesn't exist 
29 
public void sendFile( String nameOfFile, int packetSize, int offset ) throws 
IOException, FileNotFoundException { 
File file = new File( nameOfFile ); 
int numOfBytes = ( int ) file length; 
int numOfPackets = (numOfBytes / packetSize ) + 1; 
System.out.printIn( nameOfFile ); 


//sending the file total number of bytes 
outObjectToClient.writeInt( numOfBytes ); 
outObjectToClient.flushQ; 

System.out.printIn( "File size sent "+ numOfBytes + " bytes" ); 


// open a sream to the file 
FileInputStream inFile = new FileInputStream( nameOfFile ); 
byte[] fileInBytes = new byte[numOfBytes + packetSize]; 


//read the bytes from the file 
inFile.read( fileInBytes ); 


System.out.printIn( "Client: " + 
( clientSocket.getInetAddress() ).toString() 
+" from port " + clientSocket.getPort() 
+" asked for file " + nameOfFile 
+ "\nOffset: " + offset ); 


int currentPacket = offset; 


try{ 
//send the packets 
setNumberOfTotalTransfers( getNumberOfTotalTransfers() + 1 ); 
while( currentPacket < numOfPackets ){ 
outObjectToClient.write( fileInBytes, currentPacket * packetSize, 
packetSize ); 
outObjectToClient.flushQ; 
System.out.printIn( "Bytes " + currentPacket * packetSize + " to" + 
( currentPacket + 1 ) * packetSize +" sent" ); 
delay( 500 ); 


currentPacket++; 
} //end while loop 
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//check if the transfer ends 


if( currentPacket == numOfPackets && 
inObjectFromClient.readBoolean() ){ 
System.out.printin( "File is sent!" ); 
} /fend if 


} catch( IOException ioe ){ 
System.out.printin( ioe ); 
setNumberOfTransferFailures( getNumberOfTransferFailures() + 1 ); 
} //end try catch block 
} // end sendFile() method 
} //end ClientHandler inner class 


[** 

* A panel that contains useful informations about the server 
* operation status. 

| 

private class PFTPServerStatusPanel extends JPanel { 


/** The PFTP server that has this panel */ 
private PFTPServer serverStatusPanelServer; 


/** The title of the status panel */ 
private JTextPane serverStatusPanelTitle; 


/** The textpane that shows the number of current clients */ 
private JTextPane numberOfCurrentClientsInfo; 


/** The textpane that shows the number of total file transfers */ 
private JTextPane numberOfTotalTransfersInfo; 


/** The textpane that shows the number of failed file transfers */ 
private JTextPane percentageOfTransferFailuresInfo; 


/** The textpane that shows the number of local files in server's database */ 
private JTextPane numberOfLocalFilesInfo; 


[** 


* Constructor 
ok 


* @param server the PFTPServer that owns the panel 
*/ 

public PFTPServerStatusPanel( PFTPServer server ){ 
super(); 
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serverStatusPanelServer = server; 
setBorder( BorderFactory.createLineBorder( PANEL_BORDER_COLOR ) ); 


numberOfCurrentClientsInfo = getTitledPanel( "", PANEL_LABEL_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ); 
numberOfCurrentClientsInfo.setForeground( FONT_COLOR ); 


numberOfTotalTransfersInfo = getTitledPanel( "", PANEL_LABEL_FONT_SIZE, 

FONT_COLOR, 

BACKGROUND_COLOR, false, true ); 
numberOfTotalTransfersInfo.setForeground( FONT_COLOR ); 
percentageOfTransferFailuresInfo = getTitledPanel( "", 

PANEL_LABEL FONT_SIZE, 

FONT_COLOR, 

BACKGROUND_COLOR, false, true ); 
percentageOfTransferFailuresInfo.setForeground( FONT_COLOR ); 


numberOfLocalFilesInfo = getTitledPanel( "", 
PANEL_LABEL_ FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ); 
numberOfLocalFilesInfo.setForeground( FONT_COLOR ); 


setBackground( BACKGROUND_COLOR ); 
setLayout( new GridLayout( 5, 2 ) ); 


add(_— getTitledPanel( "SERVER STATUS", PANEL_TITLE_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, true, true ) ); 


add( getTitledPanel( "", PANEL_LABEL_FONT_SIZE, FONT_COLOR, 
BACKGROUND_COLOR, false, true ) ); 


add( getTitledPanel( "Current clients :", PANEL_LABEL_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ) ); 

add( numberOfCurrentClientsInfo ); 

add( getTitledPanel( "Total file transfers :", PANEL_LABEL_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ) ); 
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add( numberOfTotalTransfersInfo ); 


add( getTitledPanel( "Transfer failures :", PANEL_LABEL_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ) ); 


add( percentageOfTransferFailuresInfo ); 


add( getTitledPanel( "Files in database :", PANEL_LABEL_FONT_SIZE, 
FONT_COLOR, 
BACKGROUND_COLOR, false, true ) ); 


add( numberOfLocalFilesInfo ); 


setVisible( false ); 
setEnabled( false ); 


} 


[** 


* Return a titled JTextPanel with specific attributes 

k 

* @param titleText the delay time in milliseconds 

* @param charSize the character size 

* @param charColor the character color 

* @param backgroundColor the backgroundColor 

* @param isUnderlined if the character is underlined or not 

* @param isBold if the character is bold or not 

* @return a titled JtextPanel with specific attributes 

public JTextPane getTitledPanel( String titleText, int charSize, 

Color charColor, Color backgroundColor, 
boolean isUnderlined, boolean isBold ){ 

JTextPane textPane; 

DefaultStyledDocument doc = new DefaultStyledDocument(); 

textPane = new JTextPane( doc ); 

MutableAttributeSet attr = new SimpleAttributeSet(); 

StyleConstants.setFontSize( attr, charSize ); 

StyleConstants.setUnderline( attr, isUnderlined ); 

StyleConstants.setForeground( attr, charColor ); 

StyleConstants.setBold( attr, isBold ); 

textPane.setEditable( false ); 

textPane.setEnabled( false ); 

textPane.setBackground( backgroundColor ); 

textPane.setCharacterAttributes( attr, true ); 
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textPane.setText( titleText ); 
return textPane; 
} //end getTitledPanel() method 


[** 
* Updates file transfer's status 
af 
public synchronized void updateServerStatus() { 
notify; 
numberOfCurrentClientsInfo.setText( new Integer( 
serverStatusPanelServer.getNumberOfCurrentClients() ).toString() ); 
numberOfTotalTransfersInfo.setText( new Integer( 
serverStatusPanelServer.getNumberOfTotalTransfers() ).toString() ); 
percentageOfTransferFailuresInfo.setText( new Double( 
serverStatusPanelServer.getPercentageOfTransferFailures() ).toString() + 
ye 
numberOfLocalFilesInfo.setText( new Integer( 
serverStatusPanelServer.getNumberOfLocalFiles() ).toString() ); 
} //end updateFileTransferStatus() method 


[** 


* Resets the panel 
*/ 
public void reset() { 


Swing Utilities .invokeLater( 
new UpdateTextPane( numberOfCurrentClientsInfo, "" ) ); 


Swing Utilities .invokeLater( 
new UpdateTextPane( numberOfTotalTransfersInfo, "" ) ); 


Swing Utilities .invokeLater( 
new UpdateTextPane( percentageOfTransferFailuresInfo, "" ) ); 


SwingUtilities.invokeLater( 
new UpdateTextPane( numberOfLocalFilesInfo, "" ) ); 


} //end reset() method 


[** 


* Updates a TextPane 
Py, 
public class UpdateTextPane extends Thread { 


/** The text pane to update */ 
private JTextPane textPane; 
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/** The the text to set to the text pane */ 
private String text; 


[** 


* Constructor 
ok 


* @param jTextPane the text pane to update 
* @param aText the text to be shown on the text pane 
=] 
public UpdateTextPane( JTextPane jTextPane, String aText ){ 
textPane = jTextPane; 
text = aText; 
} //fend constructor 


// method called to update outputArea 
public void run({ 

textPane.setText( text ); 
} /fend run() method 


} // end class UpdateThread 


} 


[** 


* Updates a TextPane 
*/ 
private class DeleteFileFrame extends JFrame { 


/** The combo box with files to select */ 
private JComboBox filesToDelete; 


/** The string array with file names available to delete */ 
private String[] fileNames; 


/** The button to use for deleting */ 
private JButton deleteButton; 


/** The file name selected to be deleted */ 
private String fileSelected; 


[** 


* Constructor 
ok 


* @param theFileNames the frame's string array with files names to delete 
a 
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public DeleteFileFrame( String[] theFileNames ){ 
super( "Delete file" ); 


// get content pane and set its layout 
Container container = getContentPane(); 
container.setLayout( new GridLayout( 4, 1 ) ); 


fileNames = theFileNames; 
fileSelected = null; 


addPanel(container); 


// set up delete file JComboBox 

filesToDelete = new JComboBox( fileNames ); 
filesToDelete.setBackground( BACKGROUND_COLOR ); 
filesToDelete.setForeground( FONT_COLOR ); 
filesToDelete.addItemListener( 


// anonymous inner class to handle JComboBox events 
new ItemListener(){ 


// handle JComboBox event 
public void itemStateChanged( ItemEvent event ){ 
// determine whether check box selected 
if( event.getStateChange() == ItemEvent.SELECTED ) 
fileSelected = fileNames[filesToDelete.getSelectedIndex()]; 
deleteButton.setEnabled( true ); 
}//end itemStateChanged() method 


} // end anonymous inner class 
); / end call to addItemListener 
container.add( filesToDelete ); 
addPanel(container); 


// set up delete button 

deleteButton = new JButton( "Delete file" ); 

deleteButton.setEnabled( false ); 

deleteButton.setBackground( BACKGROUND_COLOR ); 

deleteButton.setForeground( FONT_COLOR ); 

deleteButton.addActionListener( new ActionListener() { 
public void actionPerformed( ActionEvent event ){ 

removeFromDatabase( fileSelected ); 
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setVisible( false ); 
} //fend actionPerformed() method 
} /fend ActionListener class 
); /end addActionListener() method 


container.add( deleteButton ); 


setSize( 250, 200 ); 
setLocation( 340, 250 ); 
setResizable( false ); 
setDefaultCloseOperation( JFrame. HIDE_ON_CLOSE ); 
setVisible( true ); 
} //end constructor 


} // end class DeleteFileFrame 


} // end PFTPServer class 
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//packages for transmiting the object over 
//an input and output stream 
import java.io.Serializable; 


/ oh 
* File PFTPFileRequest.java 
* 


* Provides an object to hold the data of the file transfer request 
ES 
* @author LT Periklis Pantoleon 
* @version 1.0 
*/ 
public class PFTPFileRequest 
implements Serializable { 


/** The type of the file request */ 
private int requestT ype; 


/** The file to request */ 
private String file; 


/** The hash value of the file */ 
private String hash; 


/** The byte offset */ 
private int offset; 


/** The socket to comunicate with the client */ 
private int packetSize; 


[** 
* Constructor 
ES 
* @param theRequestType the type of the request 1 if it is file request and 
- 0 if it is available files request 
* @param theFileName the file name 
* @param theFileHash the file hash value 
* @param theFileOffset the file offset 
* @param thePacketSize the file transfer packet size 
sa | 
public PFTPFileRequest(int theRequestType, 
String theFileName, 
String theFileHash, 
int theFileOffset, 
int thePacketSize) { 
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this.requestT ype = theRequestT ype; 
this.file = theFileName; 

this.hash = theFileHash; 

this.offset = theFileOffset; 
this.packetSize = thePacketSize; 


} //end FileRequest class constructor 


[** 
* Gets the request type 
* 


* @return the request type 

aa | 

public int getRequestType() { 
return requestType; 

} //end getRequestType() method 


[** 
* Gets the file name 
ok 
* @return the file name 
aid 
public String getFile() { 
return file; 
} //end getFile(Q) method 


[** 


* Gets the file hash value 

ok 

* @return the file hash value 
ai 

public String getHash() { 
return hash; 

} //end getHash() method 


[** 

* Gets the offset 

ok 

* @return the offset 

t/ 
public int getOffset() { 
return offset; 

} //end getOffset() method 
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[** 

* Gets the packet size 

* 

* @return the packet size 

oy 

public int getPacketSize() { 
return packetSize; 

} // end getPacketSize() method 


[** 
* Sets the request type 
* 
* @param newRequestType the request type 
a | 
public void setRequestType(int newRequestType) { 
this.requestl ype = newRequestType; 
} //end setRequestType() method 


[** 

* Sets the file name 

ES 

* @param newFile the file name 

a 

public void setFile(String newFile) { 
this.file = newFile; 

} // end setFileQ) method 


[** 

* Sets the file hash value 

ES 

* @param newHash the file hash value 
ef 

public void setHash(String newHash) { 
this.hash = newHash; 

} // end setHash() method 


[** 


* Sets the file offset 

k 

* @param newOffset the file offset 
ny 

public void setOffset(int newOffset) { 
this.offset = newOffset; 

} // end setOffset() method 


[** 
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* Sets the file transfer packet size 

ES 

* @param newPacketSize the file tranfer packet size 
*/ 

public void setPacketSize(int newPacketSize) { 
this.packetSize = newPacketSize; 

} //end getPacketSize() method 


[** 
* Checks for equality 
* 
* @param request the file request that we want to check the equality with 
* @return the true if the requests aren equal, false if they aren't 
a | 
public boolean equals(PFTPFileRequest request) { 
boolean isEqual = false; 
if (this.getFile() == request.getFile() && 
this.getHash() == request.getHash() && 
this.getOffset() == request.getOffset() && 
this.getPacketSize() == request.getPacketSize()) { 
isEqual = true; 
} 
return isEqual; 
} // end equals() method 


} // end FileRequest class 
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//packages 
import java.io.*; 
import java.util.*; 


[** 


* File AvailableFileMap.java 
* 


* This the class that is used to store the availiable to download 


* files in the PFTP server. 
BS 


* @author LT Periklis Pantoleon 
* @version 1.0 
*/ 


public class AvailableFileMap 
extends HashMap 
implements Serializable { 


/** The capacity of the file map */ 
private int capacity; 
[** 


* Default Constructor 
*/ 
public AvailableFileMap() { 


super(); 
capacity = 16; 


} //end AvailableFileMap class default constructor 


[** 


* Constructor 
ok 


* @param theCapacity the file map capacity 
| 
public AvailableFileMap(int theCapacity) { 


super(); 
capacity = theCapacity; 


} fend AvailableFileMap class constructor 


[** 


* Returns the file map capacity 
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*k 


* @return the file map capacity 
| 
public int getCapacity() { 


return capacity; 


} //end getCapacity() method 


[** 


* Sets the file map capacity 
* 


* @param newCapacity the new file map capacity 
#] 
public void setCapacity(int newCapacity) { 


capacity = newCapacity; 
} // end setCapacity() method 


[** 


* Check if there is an entry with a specific file name as key 
ES 


* @param fileName the string file name key value 
* @return hasFile true if there is an entry, false otherwise 
oy 

public boolean hasFile(String fileName) { 


boolean hasFile = this.containsKey(fileName); 
return hasFile; 


} // end hasFileQ) method 


[** 


* Returns the file byte array that mas the key file name 
* 


* @param fileName the string file name key value 
* @return the file byte array that mas the key file name 
| 

public byte[] getFileBytes(String fileName) { 


byte[] fileBytes = (byte[]) this.get(fileName); 
return fileBytes; 


} //end getFileBytes() method 
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[** 


* Add a file byte array and assosiates it with a file name 
* 


* @param fileName the file name of the file key value 
* @param fileBytes the file bytes of the key file 
if 

public void addFile(String fileName, byte[] fileBytes) { 


this.put(fileName, fileBytes); 
} // end addFile() method 


[** 


* Removes a file byte array that assosiated with a file name 
* 


* @param fileName the file name to remove from file map 
a 

public void removeFile(String fileName) { 
this.remove(fileName); 


} // end removeFile() method 


} //end AvailableFileMap class 
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//packages 

import java.awt.Canvas; 
import java.awt.Image; 
import java.awt.Graphics; 
import java.awt.Dimension; 


[** 
* File PFTPCanvas.java 
* 


* This the class that draws a Canvas with an image on it 
ES 


* @author LT Periklis Pantoleon 

* @version 1.0 

+} 
public class PFTPCanvas extends Canvas{ 


/** The image on the canvas */ 
private Image canvasImage = null; 


[** 
* Default Constructor 
*/ 
public PFTPCanvas(){ 
super(); 
} /fend PFTPCanvas class default constructor 


[** 


* Sets the image on the canvas 
ok 


* @param anImage the new image on the canvas 
*/ 

public void setImage( Image anImage ){ 
canvasImage = anImage; 

} //end setImage() method 


[** 


* Returns the image on the canvas 
* 


* @return the image on the canvas 
if 
public Image getImage() { 
return canvasImage; 
} // end setImage() method 


[** 
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* Updates the image on the canvas 
* 
* @param g the Graphics object of the canvas 
*f 
public void update( Graphics g ){ 
paint( g ); 
} // end update() method 


[** 
* Draws the image on the canvas 
* 
* @param g the Graphics object of the canvas 
a 
public void paint( Graphics g ){ 
if( canvasImage != null ){ 
Dimension size = getSize(); 
g.clearRect( 0, 0, size.width, size.height ); 
g.drawImage( canvasImage, 0, 0, this ); 
} end if 
} // end paint() method 
} // end PFTPCanvas class 
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